# Twilio - Media API

> Twilio - Media API on Apizie: 13 endpoints (Returns a list of MediaProcessors., POST /v1/MediaProcessors, Returns a single MediaProcessor resource identified by a SID., Updates a MediaProcessor resource identified by a SID., …) 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-media-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-media-v1`
- Category: Communication
- Status: byok
- Source: https://support.twilio.com
- Page: https://apizie.tech/api/communication/twilio-twilio-media-v1
- OpenAPI: https://apizie.tech/api/communication/twilio-twilio-media-v1/openapi.json

This is the public Twilio REST API.

## Endpoints

### Returns a list of MediaProcessors.
`GET https://apizie.tech/v1/communication:twilio-twilio-media-v1/list-media-processor` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Order | string | no | The sort order of the list by `date_created`. Can be: `asc` (ascending) or `desc` (descending) with `desc` as the default. |
| Status | string | no | Status to filter by, with possible values `started`, `ended` or `failed`. |
| 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/MediaProcessors
`POST https://apizie.tech/v1/communication:twilio-twilio-media-v1/create-media-processor` (byok)

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

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

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

### Updates a MediaProcessor resource identified by a SID.
`POST https://apizie.tech/v1/communication:twilio-twilio-media-v1/update-media-processor` (byok)

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

### Returns a list of MediaRecordings.
`GET https://apizie.tech/v1/communication:twilio-twilio-media-v1/list-media-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Order | string | no | The sort order of the list by `date_created`. Can be: `asc` (ascending) or `desc` (descending) with `desc` as the default. |
| Status | string | no | Status to filter by, with possible values `processing`, `completed`, `deleted`, or `failed`. |
| ProcessorSid | string | no | SID of a MediaProcessor to filter by. |
| SourceSid | string | no | SID of a MediaRecording source to filter by. |
| 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 single MediaRecording resource identified by a SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-media-v1/fetch-media-recording` (byok)

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

### Deletes a MediaRecording resource identified by a SID.
`POST https://apizie.tech/v1/communication:twilio-twilio-media-v1/delete-media-recording` (byok)

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

### Returns a list of PlayerStreamers.
`GET https://apizie.tech/v1/communication:twilio-twilio-media-v1/list-player-streamer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Order | string | no | The sort order of the list by `date_created`. Can be: `asc` (ascending) or `desc` (descending) with `desc` as the default. |
| Status | string | no | Status to filter by, with possible values `created`, `started`, `ended`, or `failed`. |
| 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/PlayerStreamers
`POST https://apizie.tech/v1/communication:twilio-twilio-media-v1/create-player-streamer` (byok)

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

### Returns a single PlayerStreamer resource identified by a SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-media-v1/fetch-player-streamer` (byok)

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

### Updates a PlayerStreamer resource identified by a SID.
`POST https://apizie.tech/v1/communication:twilio-twilio-media-v1/update-player-streamer` (byok)

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

### **This method is not enabled.** Returns a single PlaybackGrant resource identified by a SID.
`GET https://apizie.tech/v1/communication:twilio-twilio-media-v1/fetch-player-streamer-playback-grant` (byok)

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

### POST /v1/PlayerStreamers/{Sid}/PlaybackGrant
`POST https://apizie.tech/v1/communication:twilio-twilio-media-v1/create-player-streamer-playback-grant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string generated to identify the PlayerStreamer resource associated with this PlaybackGrant |
| body | object | no | Form fields as a JSON object |

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

## FAQ

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

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

### Can AI agents use the Twilio - Media 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-media-v1.

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