# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Marketing Campaigns API
  version: 1.0.0
extends: openapi/mailchimp-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: 22
- target: $.paths['/campaigns'].get
  update:
    x-apievangelist-phrasing:
      intent: List email campaigns in the account
      effect: read
      questions:
      - How do I see every campaign in my Mailchimp account?
      - Can I list only the campaigns that were sent after a certain date?
      - Which of my campaigns are still drafts versus already sent?
      instructions:
      - text: List all my campaigns.
      - text: List campaigns with status {status} sent since {since_send_time}.
        slots:
          status: query.status
          since_send_time: query.since_send_time
      - text: Show the campaigns that went to audience {list_id}.
        slots:
          list_id: query.list_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new email campaign
      effect: write
      questions:
      - How do I create a new regular email campaign through the API?
      - Can I set up an A/B test campaign when I first create it?
      - What campaign types can I start a brand-new campaign as?
      instructions:
      - text: Create a new {type} campaign.
        slots:
          type: requestBody.type
      - text: Create a {type} campaign aimed at recipients {recipients} with settings {settings}.
        slots:
          type: requestBody.type
          recipients: requestBody.recipients
          settings: requestBody.settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one campaign
      effect: read
      questions:
      - Where can I look up the settings and status of a single campaign?
      - Can I check whether a specific campaign is eligible for the resend shortcut?
      instructions:
      - text: Get the details of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show the subject line and status of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a campaign
      effect: destructive
      questions:
      - How do I permanently remove a campaign from my account?
      - Can I delete an old draft campaign I no longer need?
      instructions:
      - text: Delete campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Remove the draft campaign {campaign_id} from my account.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing campaign's settings
      effect: write
      questions:
      - How do I change the subject line or from name on a campaign I already created?
      - Can I switch the tracking options on an existing campaign?
      instructions:
      - text: Update the settings of campaign {campaign_id} to {settings}.
        slots:
          campaign_id: path.campaign_id
          settings: requestBody.settings
      - text: Change the recipients of existing campaign {campaign_id} to {recipients}, keeping settings {settings}.
        slots:
          campaign_id: path.campaign_id
          recipients: requestBody.recipients
          settings: requestBody.settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/cancel-send'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a campaign that is mid-send
      effect: destructive
      questions:
      - Can I stop a campaign after I hit send but before everyone receives it?
      - Is it possible to cancel a regular campaign that is already going out?
      instructions:
      - text: Cancel the in-progress send of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Stop campaign {campaign_id} from reaching the rest of its recipients.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/replicate'].post
  update:
    x-apievangelist-phrasing:
      intent: Duplicate a campaign
      effect: write
      questions:
      - How do I make a copy of a campaign I already sent?
      - Can I clone a saved campaign to use as a starting point?
      instructions:
      - text: Replicate campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Make a duplicate copy of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/send'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a campaign now
      effect: write
      questions:
      - How do I send a campaign immediately instead of scheduling it?
      - What happens when I trigger send on an RSS campaign?
      instructions:
      - text: Send campaign {campaign_id} right now.
        slots:
          campaign_id: path.campaign_id
      - text: Launch campaign {campaign_id} to its audience immediately.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/schedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Schedule a campaign for later delivery
      effect: write
      questions:
      - How do I schedule a campaign to go out at a specific time?
      - Can I use Timewarp so recipients get the email in their own time zone?
      - Is batch delivery available when scheduling a campaign?
      instructions:
      - text: Schedule campaign {campaign_id} for {schedule_time}.
        slots:
          campaign_id: path.campaign_id
          schedule_time: requestBody.schedule_time
      - text: Schedule campaign {campaign_id} at {schedule_time} with Timewarp set to {timewarp}.
        slots:
          campaign_id: path.campaign_id
          schedule_time: requestBody.schedule_time
          timewarp: requestBody.timewarp
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/unschedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Unschedule a scheduled campaign
      effect: write
      questions:
      - Can I take a campaign off the schedule before it starts sending?
      - What do I do if I scheduled a campaign too early and need to pull it back?
      instructions:
      - text: Unschedule campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Remove the scheduled send time from campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/test'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a test email of a campaign
      effect: write
      questions:
      - How do I send myself a test version of a campaign before it goes live?
      - Can I send the plain-text version as a test instead of HTML?
      instructions:
      - text: Send a {send_type} test of campaign {campaign_id} to {test_emails}.
        slots:
          send_type: requestBody.send_type
          campaign_id: path.campaign_id
          test_emails: requestBody.test_emails
      - text: Email a preview of campaign {campaign_id} to {test_emails} as {send_type}.
        slots:
          campaign_id: path.campaign_id
          test_emails: requestBody.test_emails
          send_type: requestBody.send_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/pause'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause an RSS-driven campaign
      effect: write
      questions:
      - Can I temporarily stop my RSS campaign from sending new posts?
      - How do I pause an RSS-to-email campaign?
      instructions:
      - text: Pause RSS campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Put the RSS-driven campaign {campaign_id} on hold.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused RSS campaign
      effect: write
      questions:
      - How do I restart an RSS campaign I paused?
      - Can a paused RSS-driven campaign pick back up where it left off?
      instructions:
      - text: Resume RSS campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Turn the paused RSS campaign {campaign_id} back on.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/actions/create-resend'].post
  update:
    x-apievangelist-phrasing:
      intent: Resend a campaign to non-openers or new subscribers
      effect: write
      questions:
      - Can I resend a campaign to people who didn't open it the first time?
      - Is there a shortcut to resend a campaign to subscribers who joined after it went out?
      instructions:
      - text: Create a resend of campaign {campaign_id} for non-openers.
        slots:
          campaign_id: path.campaign_id
      - text: Create a resend of campaign {campaign_id} using the {shortcut_type} shortcut.
        slots:
          campaign_id: path.campaign_id
          shortcut_type: requestBody.shortcut_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a campaign's HTML and plain-text content
      effect: read
      questions:
      - Where can I pull the HTML body of a campaign?
      - Can I read the plain-text version of an email I built?
      instructions:
      - text: Get the HTML and plain-text content of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show me the email body of campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/content'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the content of a campaign
      effect: write
      questions:
      - How do I upload my own HTML as the content of a campaign?
      - Can I import campaign content from a URL or build it from a template?
      instructions:
      - text: Set the HTML content of campaign {campaign_id} to {html}.
        slots:
          campaign_id: path.campaign_id
          html: requestBody.html
      - text: Import the content for campaign {campaign_id} from {url}.
        slots:
          campaign_id: path.campaign_id
          url: requestBody.url
      - text: Build campaign {campaign_id}'s content from template {template}.
        slots:
          campaign_id: path.campaign_id
          template: requestBody.template
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/feedback'].get
  update:
    x-apievangelist-phrasing:
      intent: List team feedback on a campaign
      effect: read
      questions:
      - What comments has my team left on a campaign draft?
      - Can I see all the review feedback for one campaign?
      instructions:
      - text: List all feedback comments on campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Show my team's review notes for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/feedback'].post
  update:
    x-apievangelist-phrasing:
      intent: Leave feedback on a campaign
      effect: write
      questions:
      - How do I add a review comment to a campaign my colleague is building?
      - Can I attach feedback to a specific content block in a campaign?
      instructions:
      - text: Add the feedback "{message}" to campaign {campaign_id}.
        slots:
          message: requestBody.message
          campaign_id: path.campaign_id
      - text: Comment "{message}" on block {block_id} of campaign {campaign_id}.
        slots:
          message: requestBody.message
          block_id: requestBody.block_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/feedback/{feedback_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one feedback message on a campaign
      effect: read
      questions:
      - Can I pull up a single feedback comment on a campaign by its id?
      - Is a particular review comment on my campaign marked complete?
      instructions:
      - text: Get feedback message {feedback_id} on campaign {campaign_id}.
        slots:
          feedback_id: path.feedback_id
          campaign_id: path.campaign_id
      - text: Show the text of feedback {feedback_id} from campaign {campaign_id}.
        slots:
          feedback_id: path.feedback_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/feedback/{feedback_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feedback message from a campaign
      effect: destructive
      questions:
      - How do I remove a feedback comment someone left on my campaign?
      - Can I delete a review note that is no longer relevant?
      instructions:
      - text: Delete feedback {feedback_id} from campaign {campaign_id}.
        slots:
          feedback_id: path.feedback_id
          campaign_id: path.campaign_id
      - text: Remove review comment {feedback_id} on campaign {campaign_id}.
        slots:
          feedback_id: path.feedback_id
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/feedback/{feedback_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit or resolve a campaign feedback message
      effect: write
      questions:
      - Can I mark a feedback comment on a campaign as resolved?
      - How do I edit the wording of feedback I already left?
      instructions:
      - text: Mark feedback {feedback_id} on campaign {campaign_id} as complete.
        slots:
          feedback_id: path.feedback_id
          campaign_id: path.campaign_id
      - text: Change feedback {feedback_id} on campaign {campaign_id} to say "{message}".
        slots:
          feedback_id: path.feedback_id
          campaign_id: path.campaign_id
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/campaigns/{campaign_id}/send-checklist'].get
  update:
    x-apievangelist-phrasing:
      intent: Review a campaign's pre-send checklist
      effect: read
      questions:
      - Is my campaign ready to send, or are there issues I need to fix first?
      - What problems does the send checklist flag for a campaign?
      instructions:
      - text: Run the send checklist for campaign {campaign_id}.
        slots:
          campaign_id: path.campaign_id
      - text: Check whether campaign {campaign_id} has any blocking issues before sending.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'