Twilio Recording Settings API

The Recording Settings API from Twilio — 1 operation(s) for recording settings.

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/RecordingSettings/Default Get default video recording settings · Fetch recording settings #
Ask an LLM
“Are my video recordings currently encrypted or stored in my own S3 bucket?”
“What are the default recording settings on my account?”
Tell an agent
Show my default recording settings.
Tell me where recordings are stored and whether encryption is on.
POST /v1/RecordingSettings/Default Set default video recording storage and encryption · Create recording settings #
Ask an LLM
“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?”
Tell an agent
Save recording settings {friendly_name} writing recordings to {aws_s3_url} with credentials {aws_credentials_sid}.
Turn on recording encryption under settings {friendly_name} using public key {encryption_key_sid}.

Documentation

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/twilio-recording-settings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twilio-recording-settings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Twilio - Video Recording Settings API
  description: This is the public Twilio REST API.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.52.0
servers:
- url: https://video.twilio.com
tags:
- name: Recording Settings
paths:
  /v1/RecordingSettings/Default:
    servers:
    - url: https://video.twilio.com
    description: Recording settings
    x-twilio:
      defaultOutputProperties:
      - friendly_name
      - aws_storage_enabled
      - encryption_enabled
      pathType: instance
      mountName: recording_settings
      className: recording_settings
    get:
      description: ''
      tags:
      - Recording Settings
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/video.v1.recording_settings'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchRecordingSettings
      x-maturity:
      - GA
      summary: Fetch recording settings
      x-summary-source: derived
    post:
      description: ''
      tags:
      - Recording Settings
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/video.v1.recording_settings'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateRecordingSettings
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateRecordingSettingsRequest'
      summary: Create recording settings
      x-summary-source: derived
components:
  schemas:
    video.v1.recording_settings:
      type: object
      properties:
        account_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the RecordingSettings resource.
        friendly_name:
          type:
          - string
          - 'null'
          description: The string that you assigned to describe the resource and show the user in the console
        aws_credentials_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^CR[0-9a-fA-F]{32}$
          description: The SID of the stored Credential resource.
        aws_s3_url:
          type:
          - string
          - 'null'
          format: uri
          description: The URL of the AWS S3 bucket where the recordings are stored. We only support DNS-compliant URLs like `https://documentation-example-twilio-bucket/recordings`, where `recordings` is the path in which you want the recordings to be stored. This URL accepts only URI-valid characters, as described in the <a href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
        aws_storage_enabled:
          type:
          - boolean
          - 'null'
          description: Whether all recordings are written to the `aws_s3_url`. When `false`, all recordings are stored in our cloud.
        encryption_key_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^CR[0-9a-fA-F]{32}$
          description: The SID of the Public Key resource used for encryption.
        encryption_enabled:
          type:
          - boolean
          - 'null'
          description: Whether all recordings are stored in an encrypted form. The default is `false`.
        url:
          type:
          - string
          - 'null'
          format: uri
          description: The absolute URL of the resource.
    CreateRecordingSettingsRequest:
      type: object
      required:
      - FriendlyName
      properties:
        FriendlyName:
          type: string
          description: A descriptive string that you create to describe the resource and be shown to users in the console
        AwsCredentialsSid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^CR[0-9a-fA-F]{32}$
          description: The SID of the stored Credential resource.
        EncryptionKeySid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^CR[0-9a-fA-F]{32}$
          description: The SID of the Public Key resource to use for encryption.
        AwsS3Url:
          type: string
          format: uri
          description: The URL of the AWS S3 bucket where the recordings should be stored. We only support DNS-compliant URLs like `https://documentation-example-twilio-bucket/recordings`, where `recordings` is the path in which you want the recordings to be stored. This URL accepts only URI-valid characters, as described in the <a href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
        AwsStorageEnabled:
          type: boolean
          description: Whether all recordings should be written to the `aws_s3_url`. When `false`, all recordings are stored in our cloud.
        EncryptionEnabled:
          type: boolean
          description: Whether all recordings should be stored in an encrypted form. The default is `false`.
  securitySchemes:
    accountSid_authToken:
      type: http
      scheme: basic
x-maturity:
- name: GA
  description: This product is Generally Available.