API Evangelist conversational phrasing for Twilio Recordings API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Recordings API
  version: 1.0.0
extends: openapi/twilio-recordings-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['/Rooms/{RoomSid}/Recordings'].get
  update:
    x-apievangelist-phrasing:
      intent: List the recordings made in a video room
      effect: read
      questions:
      - Which recordings were captured in a particular video room?
      - Can I filter a room's recordings by their status?
      instructions:
      - text: List the recordings from video room {room_sid}.
        slots:
          room_sid: path.RoomSid
      - text: Show recordings in room {room_sid} with status {status}.
        slots:
          room_sid: path.RoomSid
          status: query.Status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Recordings/{RecordingSid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a video recording via the legacy path
      effect: read
      questions:
      - Is there an unversioned endpoint that fetches a video recording without an account SID?
      - Can I still read a video recording from the older /Recordings path?
      instructions:
      - text: Fetch video recording {recording_sid} from the legacy unversioned endpoint.
        slots:
          recording_sid: path.RecordingSid
      - text: Use the older /Recordings path to show recording {recording_sid}.
        slots:
          recording_sid: path.RecordingSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Recordings/{RecordingSid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a video recording via the legacy path
      effect: destructive
      questions:
      - Can I delete a video recording through the unversioned endpoint without an account SID?
      - Does the older /Recordings path still support deleting a recording?
      instructions:
      - text: Delete video recording {recording_sid} through the legacy unversioned endpoint.
        slots:
          recording_sid: path.RecordingSid
      - text: Use the older /Recordings path to remove recording {recording_sid}.
        slots:
          recording_sid: path.RecordingSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/RecordingSettings/Default'].get
  update:
    x-apievangelist-phrasing:
      intent: View my default recording storage settings
      effect: read
      questions:
      - Are my video recordings being stored in my own S3 bucket?
      - Is encryption turned on for recordings by default on my account?
      instructions:
      - text: Show my default recording settings.
      - text: Check whether external AWS storage and encryption are enabled for recordings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/RecordingSettings/Default'].post
  update:
    x-apievangelist-phrasing:
      intent: Configure where and how recordings are stored
      effect: write
      questions:
      - Can I send recordings straight to my own S3 bucket instead of keeping them hosted?
      - Can I turn on encryption for recordings with my own key?
      instructions:
      - text: Store recordings in {aws_s3_url} using AWS credential {aws_credentials_sid}, labelled {friendly_name}.
        slots:
          aws_s3_url: requestBody.AwsS3Url
          aws_credentials_sid: requestBody.AwsCredentialsSid
          friendly_name: requestBody.FriendlyName
      - text: Enable recording encryption with key {encryption_key_sid} on settings {friendly_name}.
        slots:
          encryption_key_sid: requestBody.EncryptionKeySid
          friendly_name: requestBody.FriendlyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List the recordings of one call
      effect: read
      questions:
      - Which recordings were made during a specific phone call?
      - Can I pull every recording tied to one call SID?
      instructions:
      - text: List the recordings for call {call_sid} on account {account_sid}.
        slots:
          call_sid: path.CallSid
          account_sid: path.AccountSid
      - text: Show every recording made during call {call_sid} in account {account_sid}.
        slots:
          call_sid: path.CallSid
          account_sid: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start recording a call in progress
      effect: write
      questions:
      - Can I start recording a phone call that is already underway?
      - Can I get a callback when a live call's recording finishes?
      - Can I record both sides of a live call on separate channels?
      instructions:
      - text: Start recording live call {call_sid} on account {account_sid}.
        slots:
          call_sid: path.CallSid
          account_sid: path.AccountSid
      - text: Record in-progress call {call_sid} for account {account_sid} and notify {callback_url} when done.
        slots:
          call_sid: path.CallSid
          account_sid: path.AccountSid
          callback_url: requestBody.RecordingStatusCallback
      - text: Record call {call_sid} on account {account_sid} in {channels} channels.
        slots:
          call_sid: path.CallSid
          account_sid: path.AccountSid
          channels: requestBody.RecordingChannels
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Recordings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List all call recordings on an account
      effect: read
      questions:
      - What call recordings does my account hold overall?
      - Can I narrow my account's recordings to a single creation date?
      instructions:
      - text: List all voice recordings on account {account_sid}.
        slots:
          account_sid: path.AccountSid
      - text: Show account {account_sid} recordings created on {date_created}.
        slots:
          account_sid: path.AccountSid
          date_created: query.DateCreated
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Recordings/{RecordingSid}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a call recording on an account
      effect: read
      questions:
      - Can I get the details of one voice call recording on my account?
      - Where do I look up a call recording when I have its account and recording SIDs?
      instructions:
      - text: Fetch call recording {recording_sid} on account {account_sid}.
        slots:
          recording_sid: path.RecordingSid
          account_sid: path.AccountSid
      - text: Show the voice recording {recording_sid} under account {account_sid}.
        slots:
          recording_sid: path.RecordingSid
          account_sid: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Accounts/{AccountSid}/Recordings/{RecordingSid}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a call recording from an account
      effect: destructive
      questions:
      - Can I delete a voice call recording I no longer want to keep?
      - How do I remove a sensitive call recording from my account's storage?
      instructions:
      - text: Delete call recording {recording_sid} on account {account_sid}.
        slots:
          recording_sid: path.RecordingSid
          account_sid: path.AccountSid
      - text: Remove voice recording {recording_sid} from account {account_sid}.
        slots:
          recording_sid: path.RecordingSid
          account_sid: path.AccountSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Recordings/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a video track recording
      effect: read
      questions:
      - Can I get the details of a single video room track recording?
      - Is a given video track recording still processing or completed?
      instructions:
      - text: Fetch video track recording {sid}.
        slots:
          sid: path.Sid
      - text: Show the status of track recording {sid} from the v1 video API.
        slots:
          sid: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Recordings/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a video track recording
      effect: destructive
      questions:
      - Can I delete a video track recording once I've downloaded it?
      - What's the way to remove a single audio or video track recording from a room?
      instructions:
      - text: Delete video track recording {sid}.
        slots:
          sid: path.Sid
      - text: Remove track recording {sid} via the v1 video API.
        slots:
          sid: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Recordings'].get
  update:
    x-apievangelist-phrasing:
      intent: List video track recordings with filters
      effect: read
      questions:
      - Can I list only the audio track recordings from my video rooms?
      - Which track recordings are still processing?
      - Can I find every track recording for one participant or room?
      instructions:
      - text: List my video track recordings with status {status}.
        slots:
          status: query.Status
      - text: Show {media_type} track recordings grouped under {grouping_sid}.
        slots:
          media_type: query.MediaType
          grouping_sid: query.GroupingSid
      - text: Find track recordings created after {after} and before {before}.
        slots:
          after: query.DateCreatedAfter
          before: query.DateCreatedBefore
      method: generated
      generated: '2026-09-26'