Twilio

Twilio CompositionSettings API

The CompositionSettings API from Twilio — 1 operation(s) for compositionsettings.

Documentation GitHub OpenAPI

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/CompositionSettings/Default Read the default composition settings · Fetch composition settings #

Ask an LLM

“Are my video compositions stored in my own S3 bucket or encrypted?”

“What default composition settings does my account have?”

Tell an agent

Show my default composition settings.

Check where compositions are stored and whether encryption is on.

POST /v1/CompositionSettings/Default Set storage and encryption for compositions · Create composition settings #

Ask an LLM

“How do I store finished compositions in my own S3 bucket?”

“Can I encrypt compositions with an encryption key I provide?”

Tell an agent

Save composition settings {name} to store in {s3_url} using AWS credentials {aws_credentials}.

Set composition settings {name} with encryption key {encryption_key} and encryption enabled {enabled}.

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-compositionsettings-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Twilio - Video Composition 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: CompositionSettings
paths:
  /v1/CompositionSettings/Default:
    servers:
    - url: https://video.twilio.com
    description: Recording composition settings
    x-twilio:
      defaultOutputProperties:
      - friendly_name
      - aws_storage_enabled
      - encryption_enabled
      pathType: instance
      mountName: composition_settings
      className: composition_settings
    get:
      description: ''
      tags:
      - CompositionSettings
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/video.v1.composition_settings'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchCompositionSettings
      x-maturity:
      - GA
      summary: Fetch composition settings
      x-summary-source: derived
    post:
      description: ''
      tags:
      - CompositionSettings
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/video.v1.composition_settings'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateCompositionSettings
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateCompositionSettingsRequest'
      summary: Create composition settings
      x-summary-source: derived
components:
  schemas:
    video.v1.composition_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 CompositionSettings resource.
        friendly_name:
          type:
          - string
          - 'null'
          description: The string that you assigned to describe the resource and that will be shown 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 compositions are stored. We only support DNS-compliant URLs like `https://documentation-example-twilio-bucket/compositions`, where `compositions` is the path in which you want the compositions 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 compositions are written to the `aws_s3_url`. When `false`, all compositions 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 compositions are stored in an encrypted form. The default is `false`.
        url:
          type:
          - string
          - 'null'
          format: uri
          description: The absolute URL of the resource.
    CreateCompositionSettingsRequest:
      type: object
      required:
      - FriendlyName
      properties:
        FriendlyName:
          type: string
          description: A descriptive string that you create to describe the resource and show to the user 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 compositions should be stored. We only support DNS-compliant URLs like `https://documentation-example-twilio-bucket/compositions`, where `compositions` is the path in which you want the compositions 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 compositions should be written to the `aws_s3_url`. When `false`, all compositions are stored in our cloud.
        EncryptionEnabled:
          type: boolean
          description: Whether all compositions 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.