# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio - Supersim Sms Commands API
  version: 1.0.0
extends: openapi/twilio-smscommands-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: 3
- target: $.paths['/v1/SmsCommands'].get
  update:
    x-apievangelist-phrasing:
      intent: List SMS commands for Super SIMs
      effect: read
      questions:
      - Which SMS commands have been sent to or received from a particular Super SIM?
      - Can I see only the machine-to-machine commands that failed to deliver?
      instructions:
      - text: List SMS commands for SIM {sim}.
        slots:
          sim: query.Sim
      - text: Show SMS commands with status {status} in direction {direction}.
        slots:
          status: query.Status
          direction: query.Direction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/SmsCommands'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an SMS command to a SIM
      effect: write
      questions:
      - How do I send a machine-to-machine text command to an IoT device's SIM?
      - Can I get a callback once my command to the SIM has been sent?
      instructions:
      - text: Send SMS command {payload} to SIM {sim}.
        slots:
          payload: requestBody.Payload
          sim: requestBody.Sim
      - text: Text {payload} to Super SIM {sim} and notify {callback_url} after it goes out.
        slots:
          payload: requestBody.Payload
          sim: requestBody.Sim
          callback_url: requestBody.CallbackUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/SmsCommands/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one SMS command
      effect: read
      questions:
      - Was a specific SMS command delivered to the device?
      - Can I look up a single SIM command by its SID?
      instructions:
      - text: Get SMS command {sid}.
        slots:
          sid: path.Sid
      - text: Check the delivery status of SIM command {sid}.
        slots:
          sid: path.Sid
      method: generated
      generated: '2026-09-26'