---
title: "List of all Recording CompositionHook resources."
method: GET
path: "/v1/CompositionHooks"
tags: ["VideoV1CompositionHook"]
---

# List of all Recording CompositionHook resources.

`GET /v1/CompositionHooks`

List of all Recording CompositionHook resources.

## Query parameters

- `Enabled` boolean
- `DateCreatedAfter` string, date-time
- `DateCreatedBefore` string, date-time
- `FriendlyName` string
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `composition_hooks` VideoV1CompositionHook[]
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CompositionHook resource.
    - `friendly_name` string, nullable — The string that you assigned to describe the resource. Can be up to 100 characters long and must be unique within the account.
    - `enabled` boolean, nullable — Whether the CompositionHook is active. When `true`, the CompositionHook is triggered for every completed Group Room on the account. When `false`, the CompositionHook is never triggered.
    - `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_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `sid` string, nullable — The unique string that we created to identify the CompositionHook resource.
    - `audio_sources` string[], nullable — The array of track names to include in the compositions created by the composition hook. A composition triggered by the composition hook 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`. Please, be aware that either video_layout or audio_sources have to be provided to get a valid creation request
    - `audio_sources_excluded` string[], nullable — The array of track names to exclude from the compositions created by the composition hook. A composition triggered by the composition hook 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 intervals with no media are clipped, as specified in the POST request that created the CompositionHook resource. 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' — The container format of the media files used by the compositions created by the composition hook. If `mp4` or `webm`, `audio_sources` must have one or more tracks and/or a `video_layout` element must contain a valid `video_sources` list, otherwise an error occurs.
    - `status_callback` string, uri, nullable — The URL we call using the `status_callback_method` to send status information to your application.
    - `status_callback_method` 'GET' | 'POST', http-method, nullable — The HTTP method we should use to call `status_callback`. Can be `POST` or `GET` and defaults to `POST`.
    - `url` string, uri, nullable — The absolute URL of the resource.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

[API](https://skmtc.net/twilio/apis/video-v1.md) · [All operations](https://skmtc.net/twilio/apis/video-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/video-v1/revisions/162f62d432a2/schema)