# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Messaging Messages API
  version: 1.0.0
extends: openapi/twilio-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: 5
- target: $.paths['/Accounts/{AccountSid}/Messages.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List sent and received messages
      effect: read
      questions:
      - Which text messages did my account send to a particular phone number?
      - Can I see every SMS that went out on a specific day?
      - What messages came in from one sender, newest first?
      instructions:
      - text: List messages on account {account} sent to {to}.
        slots:
          account: path.AccountSid
          to: query.To
      - text: Show messages from {from} on account {account}.
        slots:
          from: query.From
          account: path.AccountSid
      - text: List all messages account {account} sent on {date}.
        slots:
          account: path.AccountSid
          date: query.DateSent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Messages.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an SMS or MMS message
      effect: write
      questions:
      - How do I send a text message to a customer's phone number with Twilio?
      - Can I attach an image to a text and send it as MMS?
      - Is it possible to schedule a text to go out later instead of right now?
      - Can I send a message using a content template and fill in its variables?
      instructions:
      - text: 'Text {to} from {from} on account {account}: {body}'
        slots:
          to: requestBody.To
          from: requestBody.From
          account: path.AccountSid
          body: requestBody.Body
      - text: Send an MMS to {to} with the image at {media_url} from account {account}.
        slots:
          to: requestBody.To
          media_url: requestBody.MediaUrl
          account: path.AccountSid
      - text: Schedule {body} to {to} at {send_at} through messaging service {service} on account {account}.
        slots:
          body: requestBody.Body
          to: requestBody.To
          send_at: requestBody.SendAt
          service: requestBody.MessagingServiceSid
          account: path.AccountSid
      - text: Send content template {content} to {to} with variables {variables} from account {account}.
        slots:
          content: requestBody.ContentSid
          to: requestBody.To
          variables: requestBody.ContentVariables
          account: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Messages/{MessageSid}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one message
      effect: read
      questions:
      - Was a particular text message delivered, and what did it cost?
      - How can I pull up the full record of one message by its SID?
      instructions:
      - text: Show message {message} on account {account}.
        slots:
          message: path.MessageSid
          account: path.AccountSid
      - text: Check the delivery status of text {message} in account {account}.
        slots:
          message: path.MessageSid
          account: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Messages/{MessageSid}.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Redact or cancel a message
      effect: write
      questions:
      - Can I wipe the body of a sent message so its content is no longer stored?
      - How do I cancel a scheduled text before it goes out?
      instructions:
      - text: Redact the body of message {message} on account {account}.
        slots:
          message: path.MessageSid
          account: path.AccountSid
      - text: Cancel queued message {message} in account {account} by setting status {status}.
        slots:
          message: path.MessageSid
          account: path.AccountSid
          status: requestBody.Status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Messages/{MessageSid}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a message record
      effect: destructive
      questions:
      - Can I remove a message so it no longer shows up in my account logs?
      - What happens to a text's log entry when I delete the message record?
      instructions:
      - text: Delete message {message} from account {account}.
        slots:
          message: path.MessageSid
          account: path.AccountSid
      - text: Remove the record of text {message} from the logs of account {account}.
        slots:
          message: path.MessageSid
          account: path.AccountSid
      method: generated
      generated: '2026-09-26'