# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Voice Queues API
  version: 1.0.0
extends: openapi/twilio-queues-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}/Queues.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List my call queues
      effect: read
      questions:
      - Which call queues are set up on my Twilio account?
      - Where can I see all the hold queues callers can wait in?
      instructions:
      - text: List all call queues on account {account}.
        slots:
          account: path.AccountSid
      - text: Show every voice queue in account {account}.
        slots:
          account: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Queues.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a call queue
      effect: write
      questions:
      - How do I set up a queue for callers to wait in until an agent is free?
      - Can I cap how many calls a new queue will hold?
      instructions:
      - text: Create a call queue named {name} on account {account}.
        slots:
          name: requestBody.FriendlyName
          account: path.AccountSid
      - text: Make a new queue {name} in account {account} that holds at most {max_size} calls.
        slots:
          name: requestBody.FriendlyName
          account: path.AccountSid
          max_size: requestBody.MaxSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Queues/{QueueSid}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a call queue
      effect: read
      questions:
      - How do I check the settings of one specific call queue?
      - Can I see a single queue's size limit and name?
      instructions:
      - text: Show queue {queue} on account {account}.
        slots:
          queue: path.QueueSid
          account: path.AccountSid
      - text: Get the details of call queue {queue} in account {account}.
        slots:
          queue: path.QueueSid
          account: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Queues/{QueueSid}.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or resize a call queue
      effect: write
      questions:
      - Can I raise the maximum size of a queue that already exists?
      - Is renaming an existing call queue allowed?
      instructions:
      - text: Set the max size of queue {queue} in account {account} to {max_size}.
        slots:
          queue: path.QueueSid
          account: path.AccountSid
          max_size: requestBody.MaxSize
      - text: Rename existing queue {queue} on account {account} to {name}.
        slots:
          queue: path.QueueSid
          account: path.AccountSid
          name: requestBody.FriendlyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Queues/{QueueSid}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a call queue
      effect: destructive
      questions:
      - How do I remove a call queue I don't use anymore?
      - Can I delete a hold queue from my account?
      instructions:
      - text: Delete queue {queue} from account {account}.
        slots:
          queue: path.QueueSid
          account: path.AccountSid
      - text: Remove the unused call queue {queue} in account {account}.
        slots:
          queue: path.QueueSid
          account: path.AccountSid
      method: generated
      generated: '2026-09-26'