---
title: "POST /v1/Compositions"
method: POST
path: "/v1/Compositions"
---

# POST /v1/Compositions

`POST /v1/Compositions`

## Response `201`

Created

- VideoV1Composition
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Composition resource.
  - `status` 'enqueued' | 'processing' | 'completed' | 'deleted' | 'failed'
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_completed` string, date-time, nullable — The date and time in GMT when the composition's media processing task finished, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_deleted` string, date-time, nullable — The date and time in GMT when the composition generated media was deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `sid` string, nullable — The unique string that we created to identify the Composition resource.
  - `room_sid` string, nullable — The SID of the Group Room that generated the audio and video tracks used in the composition. All media sources included in a composition must belong to the same Group Room.
  - `audio_sources` string[], nullable — The array of track names to include in the composition. The composition includes all audio sources specified in `audio_sources` except those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` includes tracks named `student` as well as `studentTeam`.
  - `audio_sources_excluded` string[], nullable — The array of track names to exclude from the composition. The composition includes all audio sources specified in `audio_sources` except for those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` excludes `student` as well as `studentTeam`. This parameter can also be empty.
  - `video_layout` unknown
  - `resolution` string, nullable — The dimensions of the video image in pixels expressed as columns (width) and rows (height). The string's format is `{width}x{height}`, such as `640x480`.
  - `trim` boolean, nullable — Whether to remove intervals with no media, as specified in the POST request that created the composition. Compositions with `trim` enabled are shorter when the Room is created and no Participant joins for a while as well as if all the Participants leave the room and join later, because those gaps will be removed. See [Specifying Video Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
  - `format` 'mp4' | 'webm'
  - `bitrate` integer, nullable — The average bit rate of the composition's media.
  - `size` integer, nullable — The size of the composed media file in bytes.
  - `duration` integer, nullable — The duration of the composition's media file in seconds.
  - `media_external_location` string, uri, nullable — The URL of the media file associated with the composition when stored externally. See [External S3 Compositions](/docs/video/api/external-s3-compositions) for more details.
  - `status_callback` string, uri, nullable — The URL called using the `status_callback_method` to send status information on every composition event.
  - `status_callback_method` 'HEAD' | 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE', http-method, nullable — The HTTP method used to call `status_callback`. Can be: `POST` or `GET`, defaults to `POST`.
  - `url` string, uri, nullable — The absolute URL of the resource.
  - `links` object, nullable — The URL of the media file associated with the composition.

---

[API](https://skmtc.dev/twilio/apis/video-v1.md) · [All operations](https://skmtc.dev/twilio/apis/video-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/video-v1/revisions/d640d10825ae?raw)