API Evangelist conversational phrasing for Plunk Campaigns API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Plunk Campaigns API
  version: 1.0.0
extends: openapi/plunk-campaigns-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/campaigns'].get
  update:
    x-apievangelist-phrasing:
      intent: List email campaigns
      effect: read
      questions:
      - Which email campaigns do I have in Plunk right now?
      - Can I filter my campaigns by status, like only drafts or only sent ones?
      - Is there a way to search campaigns by subject line or sender address?
      instructions:
      - text: List all my email campaigns, newest first.
      - text: Show campaigns with status {status}.
        slots:
          status: query.status
      - text: Find campaigns whose name or subject matches {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a draft campaign
      effect: write
      questions:
      - Can I change the subject line of a campaign that's still a draft?
      - What parts of a draft campaign can I edit before it goes out?
      instructions:
      - text: Change the subject of draft campaign {id} to {subject}.
        slots:
          id: requestBody.id
          subject: requestBody.subject
      - text: Replace the email body of draft campaign {id} with {body}.
        slots:
          id: requestBody.id
          body: requestBody.body
      - text: Update the recipients of draft campaign {id} to {recipients}.
        slots:
          id: requestBody.id
          recipients: requestBody.recipients
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new email campaign draft
      effect: write
      questions:
      - How do I set up a new marketing email campaign?
      - Can a new campaign target just one segment instead of every contact?
      - Does the sender domain need to be verified before I create a campaign?
      instructions:
      - text: Create a campaign called {name} with subject {subject} from {from} going to all contacts, body {body}.
        slots:
          name: requestBody.name
          subject: requestBody.subject
          from: requestBody.from
          body: requestBody.body
      - text: Draft a campaign {name} for segment {segmentId} with subject {subject}, sender {from}, and body {body}.
        slots:
          name: requestBody.name
          segmentId: requestBody.segmentId
          subject: requestBody.subject
          from: requestBody.from
          body: requestBody.body
      - text: Start a new campaign draft {name} aimed at audience type {audienceType}.
        slots:
          name: requestBody.name
          audienceType: requestBody.audienceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a campaign
      effect: destructive
      questions:
      - Can I permanently remove a campaign I no longer need?
      - What happens when I delete a campaign by its id?
      instructions:
      - text: Delete campaign {id}.
        slots:
          id: requestBody.id
      - text: Remove the campaign with id {id} from my project.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{id}/send'].post
  update:
    x-apievangelist-phrasing:
      intent: Send or schedule a campaign now or later
      effect: write
      questions:
      - How do I schedule a campaign to go out at a specific date and time?
      - If I leave out the scheduled time, does the campaign send right away?
      instructions:
      - text: Schedule campaign {id} to go out at {scheduledFor}.
        slots:
          id: path.id
          scheduledFor: requestBody.scheduledFor
      - text: Send campaign {id} immediately to its audience.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/send'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a campaign live or as a test, with delay
      effect: write
      questions:
      - Can I do a test send of a campaign before sending it for real?
      - Is there a way to delay a campaign by a number of minutes before it sends?
      instructions:
      - text: Do a test send of campaign {id} rather than a live one.
        slots:
          id: requestBody.id
      - text: Send campaign {id} live with {live} set, after a {delay}-minute delay.
        slots:
          id: requestBody.id
          live: requestBody.live
          delay: requestBody.delay
      method: generated
      generated: '2026-09-26'