# Twilio - Video API

> Twilio - Video API on Apizie: 39 endpoints (Returns a single Composition resource identified by a Composition SID., Delete a Recording Composition resource identified by a Composition SID., List of all Recording compositions., POST /v1/Compositions, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/communication:twilio-twilio-video-v1/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:twilio-twilio-video-v1`
- Category: Communication
- Status: byok
- Source: https://support.twilio.com
- Page: https://apizie.tech/api/communication/twilio-twilio-video-v1
- OpenAPI: https://apizie.tech/api/communication/twilio-twilio-video-v1/openapi.json

This is the public Twilio REST API.

## Endpoints

### Returns a single Composition resource identified by a Composition SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-composition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the Composition resource to fetch. |

### Delete a Recording Composition resource identified by a Composition SID.
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/delete-composition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the Composition resource to delete. |

### List of all Recording compositions.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-composition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Status | string | no | Read only Composition resources with this status. Can be: `enqueued`, `processing`, `completed`, `deleted`, or `failed`. |
| DateCreatedAfter | string | no | Read only Composition resources created on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time zone. |
| DateCreatedBefore | string | no | Read only Composition resources created before this ISO 8601 date-time with time zone. |
| RoomSid | string | no | Read only Composition resources with this Room SID. |
| PageSize | integer | no | How many resources to return in each list page. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### POST /v1/Compositions
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/create-composition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Returns a single CompositionHook resource identified by a CompositionHook SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-composition-hook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the CompositionHook resource to fetch. |

### POST /v1/CompositionHooks/{Sid}
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-composition-hook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the CompositionHook resource to update. |
| body | object | no | Form fields as a JSON object |

### Delete a Recording CompositionHook resource identified by a `CompositionHook SID`.
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/delete-composition-hook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the CompositionHook resource to delete. |

### List of all Recording CompositionHook resources.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-composition-hook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Enabled | boolean | no | Read only CompositionHook resources with an `enabled` value that matches this parameter. |
| DateCreatedAfter | string | no | Read only CompositionHook resources created on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone. |
| DateCreatedBefore | string | no | Read only CompositionHook resources created before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone. |
| FriendlyName | string | no | Read only CompositionHook resources with friendly names that match this string. The match is not case sensitive and can include asterisk… |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### POST /v1/CompositionHooks
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/create-composition-hook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### GET /v1/CompositionSettings/Default
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-composition-settings` (byok)

### POST /v1/CompositionSettings/Default
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/create-composition-settings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Returns a single Recording resource identified by a Recording SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the Recording resource to fetch. |

### Delete a Recording resource identified by a Recording SID.
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/delete-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the Recording resource to delete. |

### List of all Track recordings.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Status | string | no | Read only the recordings that have this status. Can be: `processing`, `completed`, or `deleted`. |
| SourceSid | string | no | Read only the recordings that have this `source_sid`. |
| GroupingSid | array | no | Read only recordings with this `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`. |
| DateCreatedAfter | string | no | Read only recordings that started on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time zone. |
| DateCreatedBefore | string | no | Read only recordings that started before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time zone, given as… |
| MediaType | string | no | Read only recordings that have this media type. Can be either `audio` or `video`. |
| PageSize | integer | no | How many resources to return in each list page. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### GET /v1/RecordingSettings/Default
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-recording-settings` (byok)

### POST /v1/RecordingSettings/Default
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/create-recording-settings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### GET /v1/Rooms/{Sid}
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the Room resource to fetch. |

### POST /v1/Rooms/{Sid}
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-room` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the Room resource to update. |
| body | object | no | Form fields as a JSON object |

### GET /v1/Rooms
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-room` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Status | string | no | Read only the rooms with this status. Can be: `in-progress` (default) or `completed` |
| UniqueName | string | no | Read only rooms with the this `unique_name`. |
| DateCreatedAfter | string | no | Read only rooms that started on or after this date, given as `YYYY-MM-DD`. |
| DateCreatedBefore | string | no | Read only rooms that started before this date, given as `YYYY-MM-DD`. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### POST /v1/Rooms
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/create-room` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### GET /v1/Rooms/{RoomSid}/Participants/{Sid}
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the Participant resource to fetch. |
| Sid | string | yes | The SID of the RoomParticipant resource to fetch. |

### POST /v1/Rooms/{RoomSid}/Participants/{Sid}
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-room-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the participant to update. |
| Sid | string | yes | The SID of the RoomParticipant resource to update. |
| body | object | no | Form fields as a JSON object |

### GET /v1/Rooms/{RoomSid}/Participants
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-room-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the Participant resources to read. |
| Status | string | no | Read only the participants with this status. Can be: `connected` or `disconnected`. For `in-progress` Rooms the default Status is… |
| Identity | string | no | Read only the Participants with this [User](https://www.twilio.com/docs/chat/rest/user-resource) `identity` value. |
| DateCreatedAfter | string | no | Read only Participants that started after this date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. |
| DateCreatedBefore | string | no | Read only Participants that started before this date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### POST /v1/Rooms/{RoomSid}/Participants/{Sid}/Anonymize
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-room-participant-anonymize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the participant to update. |
| Sid | string | yes | The SID of the RoomParticipant resource to update. |

### Returns a single Track resource represented by TrackName or SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-participant-published-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource where the Track resource to fetch is published. |
| ParticipantSid | string | yes | The SID of the Participant resource with the published track to fetch. |
| Sid | string | yes | The SID of the RoomParticipantPublishedTrack resource to fetch. |

### Returns a list of tracks associated with a given Participant. Only `currently` Published Tracks are in the…
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-room-participant-published-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource where the Track resources to read are published. |
| ParticipantSid | string | yes | The SID of the Participant resource with the published tracks to read. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Returns a list of Subscribe Rules for the Participant.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-participant-subscribe-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource where the subscribe rules to fetch apply. |
| ParticipantSid | string | yes | The SID of the Participant resource with the subscribe rules to fetch. |

### Update the Subscribe Rules for the Participant
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-room-participant-subscribe-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource where the subscribe rules to update apply. |
| ParticipantSid | string | yes | The SID of the Participant resource to update the Subscribe Rules. |
| body | object | no | Form fields as a JSON object |

### Returns a single Track resource represented by `track_sid`. Note: This is one resource with the Video API…
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-participant-subscribed-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room where the Track resource to fetch is subscribed. |
| ParticipantSid | string | yes | The SID of the participant that subscribes to the Track resource to fetch. |
| Sid | string | yes | The SID of the RoomParticipantSubscribedTrack resource to fetch. |

### Returns a list of tracks that are subscribed for the participant.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-room-participant-subscribed-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource with the Track resources to read. |
| ParticipantSid | string | yes | The SID of the participant that subscribes to the Track resources to read. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### GET /v1/Rooms/{RoomSid}/Recordings/{Sid}
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource with the recording to fetch. |
| Sid | string | yes | The SID of the RoomRecording resource to fetch. |

### DELETE /v1/Rooms/{RoomSid}/Recordings/{Sid}
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/delete-room-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the RoomRecording resource to delete. |
| Sid | string | yes | The SID of the RoomRecording resource to delete. |

### GET /v1/Rooms/{RoomSid}/Recordings
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-room-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the RoomRecording resources to read. |
| Status | string | no | Read only the recordings with this status. Can be: `processing`, `completed`, or `deleted`. |
| SourceSid | string | no | Read only the recordings that have this `source_sid`. |
| DateCreatedAfter | string | no | Read only recordings that started on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone. |
| DateCreatedBefore | string | no | Read only Recordings that started before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Returns a list of Recording Rules for the Room.
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-recording-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource where the recording rules to fetch apply. |

### Update the Recording Rules for the Room
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-room-recording-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the Room resource where the recording rules to update apply. |
| body | object | no | Form fields as a JSON object |

### GET /v1/Rooms/{RoomSid}/Transcriptions/{Ttid}
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-room-transcriptions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the transcriptions resource to fetch. |
| Ttid | string | yes | The Twilio type id of the transcriptions resource to fetch. |

### POST /v1/Rooms/{RoomSid}/Transcriptions/{Ttid}
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/update-room-transcriptions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the transcriptions resource to update. |
| Ttid | string | yes | The Twilio type id of the transcriptions resource to update. |
| body | object | no | Form fields as a JSON object |

### GET /v1/Rooms/{RoomSid}/Transcriptions
`GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/list-room-transcriptions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room with the transcriptions resources to read. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### POST /v1/Rooms/{RoomSid}/Transcriptions
`POST https://apizie.tech/v1/communication:twilio-twilio-video-v1/create-room-transcriptions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| RoomSid | string | yes | The SID of the room new transcriptions resource to be created. |
| body | object | no | Form fields as a JSON object |

## Example
```
curl "https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-composition" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio - Video API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:twilio-twilio-video-v1/fetch-composition with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio - Video API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio - Video itself also needs your own key from twilio.

### Can AI agents use the Twilio - Video API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:twilio-twilio-video-v1.

### What is the status of the Twilio - Video API?
Needs your own provider key (bring your own key)