# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Transactional Messages API
  version: 1.0.0
extends: openapi/mailchimp-messages-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: 13
- target: $.paths['/messages/send-sms'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a transactional SMS
      effect: write
      questions:
      - Can I send a one-off transactional text message to a phone number?
      - Is it possible to queue an SMS asynchronously instead of waiting for the send result?
      instructions:
      - text: 'Send this transactional SMS: {message}.'
        slots:
          message: requestBody.message
      - text: Text the SMS {message} and return right away without waiting for delivery status.
        slots:
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/send'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a transactional email
      effect: write
      questions:
      - How do I send a single transactional email like a password reset?
      - Can I schedule a transactional email to go out at a later time?
      - Which dedicated IP pool will my transactional email be sent from?
      instructions:
      - text: Send the transactional email {message} now.
        slots:
          message: requestBody.message
      - text: Schedule the email {message} to send at {send_at}.
        slots:
          message: requestBody.message
          send_at: requestBody.send_at
      - text: Send email {message} through the {ip_pool} IP pool.
        slots:
          message: requestBody.message
          ip_pool: requestBody.ip_pool
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/send-template'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a transactional email from a stored template
      effect: write
      questions:
      - Can I send a transactional email using one of my saved Transactional templates by name?
      - How do I fill editable regions of a template when I send it?
      instructions:
      - text: Send the transactional template {template_name} with message settings {message}.
        slots:
          template_name: requestBody.template_name
          message: requestBody.message
      - text: Email {message} using template {template_name}, filling its regions with {template_content}.
        slots:
          message: requestBody.message
          template_name: requestBody.template_name
          template_content: requestBody.template_content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/send-mc-template'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a transactional email from a Mailchimp template
      effect: write
      questions:
      - Can I send a transactional message using a template designed in the Mailchimp editor?
      - Is it possible to pin a specific version of a Mailchimp template when sending?
      instructions:
      - text: Send Mailchimp template {mc_template_id} as a transactional email with {message}.
        slots:
          mc_template_id: requestBody.mc_template_id
          message: requestBody.message
      - text: Send version {mc_template_version} of Mailchimp template {mc_template_id} using {message}.
        slots:
          mc_template_version: requestBody.mc_template_version
          mc_template_id: requestBody.mc_template_id
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search recently sent transactional emails
      effect: read
      questions:
      - How can I find a transactional email I sent to a specific address last week?
      - Can I search sent messages by tag or sender within a date range?
      - What is the default date window when searching sent messages without dates?
      instructions:
      - text: Search sent transactional emails matching {query}.
        slots:
          query: requestBody.query
      - text: Find messages sent between {date_from} and {date_to} tagged {tags}.
        slots:
          date_from: requestBody.date_from
          date_to: requestBody.date_to
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/search-time-series'].post
  update:
    x-apievangelist-phrasing:
      intent: Get hourly stats for matching sent emails
      effect: read
      questions:
      - How many of my matching transactional emails were sent, opened and clicked per hour?
      - Can I chart hourly delivery stats for messages from one sender?
      instructions:
      - text: Show hourly send and open stats for messages matching {query}.
        slots:
          query: requestBody.query
      - text: Get an hourly time series for emails from senders {senders} since {date_from}.
        slots:
          senders: requestBody.senders
          date_from: requestBody.date_from
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/info'].post
  update:
    x-apievangelist-phrasing:
      intent: Get delivery details for one sent email
      effect: read
      questions:
      - Was a particular transactional email delivered, bounced or opened?
      - What's the delivery state of one message ID I got back from a send?
      instructions:
      - text: Get the delivery info for sent message {id}.
        slots:
          id: requestBody.id
      - text: Check whether transactional email {id} was opened or bounced.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/content'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the full content of a sent email
      effect: read
      questions:
      - Can I see the exact HTML and text body of an email I recently sent?
      - How do I retrieve the rendered content of a past transactional message?
      instructions:
      - text: Show the full HTML and text content of sent message {id}.
        slots:
          id: requestBody.id
      - text: Retrieve what email {id} actually said when it went out.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/parse'].post
  update:
    x-apievangelist-phrasing:
      intent: Parse a raw MIME email into parts
      effect: read
      questions:
      - Can I break a raw MIME email into its subject, headers, body and attachments?
      - Is there a way to parse a MIME document without sending it?
      instructions:
      - text: Parse the raw MIME email {raw_message} into its parts.
        slots:
          raw_message: requestBody.raw_message
      - text: Extract headers, text and attachments from MIME document {raw_message} without sending it.
        slots:
          raw_message: requestBody.raw_message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/send-raw'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a raw MIME email
      effect: write
      questions:
      - Can I send an email I've already built as a full MIME document?
      - Is it possible to override the recipients and from address when sending raw MIME?
      instructions:
      - text: Send the raw MIME message {raw_message} as-is.
        slots:
          raw_message: requestBody.raw_message
      - text: Send MIME document {raw_message} to {to} from {from_email}.
        slots:
          raw_message: requestBody.raw_message
          to: requestBody.to
          from_email: requestBody.from_email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/list-scheduled'].post
  update:
    x-apievangelist-phrasing:
      intent: List scheduled transactional emails
      effect: read
      questions:
      - Which transactional emails are queued to go out later?
      - Can I see only the scheduled emails headed to one recipient?
      instructions:
      - text: List all my scheduled transactional emails.
      - text: Show the emails scheduled to send to {to}.
        slots:
          to: requestBody.to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/cancel-scheduled'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a scheduled email
      effect: destructive
      questions:
      - Can I stop a scheduled transactional email before it goes out?
      - What if I need to call off an email I queued for later?
      instructions:
      - text: Cancel scheduled email {id}.
        slots:
          id: requestBody.id
      - text: Stop queued message {id} from being sent.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/messages/reschedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Change when a scheduled email sends
      effect: write
      questions:
      - Can I move a scheduled transactional email to a different send time?
      - Is it possible to push back a queued message without cancelling it?
      instructions:
      - text: Reschedule email {id} to send at {send_at}.
        slots:
          id: requestBody.id
          send_at: requestBody.send_at
      - text: Move the send time of scheduled message {id} to {send_at}.
        slots:
          id: requestBody.id
          send_at: requestBody.send_at
      method: generated
      generated: '2026-09-26'