# Create composition settings

**POST /v1/CompositionSettings/Default**


Recording composition settings

## Servers
- https://video.twilio.com: https://video.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters



### Body: application/x-www-form-urlencoded (object)

- **FriendlyName** (string)
  A descriptive string that you create to describe the resource and show to the user in the console
- **AwsCredentialsSid** (string)
  The SID of the stored Credential resource.
- **EncryptionKeySid** (string)
  The SID of the Public Key resource to use for encryption.
- **AwsS3Url** (string(uri))
  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 [RFC 3986](https://tools.ietf.org/html/rfc3986#section-2).
- **AwsStorageEnabled** (boolean)
  Whether all compositions should be written to the `aws_s3_url`. When `false`, all compositions are stored in our cloud.
- **EncryptionEnabled** (boolean)
  Whether all compositions should be stored in an encrypted form. The default is `false`.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CompositionSettings resource.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource and that will be shown in the console
- **aws_credentials_sid** (string | null)
  The SID of the stored Credential resource.
- **aws_s3_url** (string(uri) | null)
  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 [RFC 3986](https://tools.ietf.org/html/rfc3986#section-2).
- **aws_storage_enabled** (boolean | null)
  Whether all compositions are written to the `aws_s3_url`. When `false`, all compositions are stored in our cloud.
- **encryption_key_sid** (string | null)
  The SID of the Public Key resource used for encryption.
- **encryption_enabled** (boolean | null)
  Whether all compositions are stored in an encrypted form. The default is `false`.
- **url** (string(uri) | null)
  The absolute URL of the resource.


[Powered by Bump.sh](https://bump.sh)