# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio - Video Recording Settings API
  version: 1.0.0
extends: openapi/twilio-recording-settings-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: 2
- target: $.paths['/v1/RecordingSettings/Default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get default video recording settings
      effect: read
      questions:
      - Are my video recordings currently encrypted or stored in my own S3 bucket?
      - What are the default recording settings on my account?
      instructions:
      - text: Show my default recording settings.
      - text: Tell me where recordings are stored and whether encryption is on.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/RecordingSettings/Default'].post
  update:
    x-apievangelist-phrasing:
      intent: Set default video recording storage and encryption
      effect: write
      questions:
      - How do I send all my video recordings to my own AWS S3 bucket?
      - Can I require every recording to be stored encrypted with my public key?
      instructions:
      - text: Save recording settings {friendly_name} writing recordings to {aws_s3_url} with credentials {aws_credentials_sid}.
        slots:
          friendly_name: requestBody.FriendlyName
          aws_s3_url: requestBody.AwsS3Url
          aws_credentials_sid: requestBody.AwsCredentialsSid
      - text: Turn on recording encryption under settings {friendly_name} using public key {encryption_key_sid}.
        slots:
          friendly_name: requestBody.FriendlyName
          encryption_key_sid: requestBody.EncryptionKeySid
      method: generated
      generated: '2026-09-26'