# 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 Ip Commands API
  version: 1.0.0
extends: openapi/twilio-ipcommands-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/IpCommands'].get
  update:
    x-apievangelist-phrasing:
      intent: List IP Commands sent to or from Super SIMs
      effect: read
      questions:
      - Which IP Commands have my Super SIM devices sent or received?
      - Can I see only the commands that failed to deliver?
      - Is there a way to list the commands for one SIM by its ICCID?
      instructions:
      - text: List IP Commands for SIM {sim}.
        slots:
          sim: query.Sim
      - text: Show IP Commands with status {status} going {direction}.
        slots:
          status: query.Status
          direction: query.Direction
      - text: List the IP Commands exchanged with ICCID {iccid}.
        slots:
          iccid: query.SimIccid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/IpCommands'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an IP Command to a Super SIM device
      effect: write
      questions:
      - How do I push a small data payload to an IoT device over its Super SIM?
      - What is the size limit on an IP Command payload?
      instructions:
      - text: Send {payload} to SIM {sim} on device port {port}.
        slots:
          payload: requestBody.Payload
          sim: requestBody.Sim
          port: requestBody.DevicePort
      - text: Send IP Command {payload} to {sim} port {port} and call {callback} once sent.
        slots:
          payload: requestBody.Payload
          sim: requestBody.Sim
          port: requestBody.DevicePort
          callback: requestBody.CallbackUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/IpCommands/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one IP Command
      effect: read
      questions:
      - Was a specific IP Command delivered to the device?
      - Can I see the payload and status of one IP Command?
      instructions:
      - text: Show IP Command {command}.
        slots:
          command: path.Sid
      - text: Check the delivery status of IP Command {command}.
        slots:
          command: path.Sid
      method: generated
      generated: '2026-09-26'