Mux Video API
OpenAPI 3.1 definition for Mux Video assets, playback IDs and direct uploads.
Connect this API to an AI agent Browse all specs
What you can do with Mux Video API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /video/v1/assets |
getVideoV1Assets | List assets Method: GET Path: /video/v1/assets IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - limit: limit parameter. - page: page parameter. |
| POST | /video/v1/assets |
postVideoV1Assets | Create an asset Method: POST Path: /video/v1/assets IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /video/v1/assets/{assetId} |
getVideoV1AssetsByAssetid | Get an asset Method: GET Path: /video/v1/assets/{assetId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - assetId: assetId parameter. |
| DELETE | /video/v1/assets/{assetId} |
deleteVideoV1AssetsByAssetid | Delete an asset Method: DELETE Path: /video/v1/assets/{assetId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - assetId: assetId parameter. |
| POST | /video/v1/assets/{assetId}/playback-ids |
postVideoV1AssetsByAssetidPlaybackIds | Create a playback ID Method: POST Path: /video/v1/assets/{assetId}/playback-ids IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - assetId: assetId parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| DELETE | /video/v1/assets/{assetId}/playback-ids/{playbackId} |
deleteVideoV1AssetsByAssetidPlaybackIdsByPlaybackid | Delete a playback ID Method: DELETE Path: /video/v1/assets/{assetId}/playback-ids/{playbackId} IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - assetId: assetId parameter. - playbackId: playbackId parameter. |
| POST | /video/v1/uploads |
postVideoV1Uploads | Create a direct upload Method: POST Path: /video/v1/uploads IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /video/v1/uploads/{uploadId} |
getVideoV1UploadsByUploadid | Get a direct upload Method: GET Path: /video/v1/uploads/{uploadId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - uploadId: uploadId parameter. |
| DELETE | /video/v1/uploads/{uploadId} |
deleteVideoV1UploadsByUploadid | Cancel a direct upload Method: DELETE Path: /video/v1/uploads/{uploadId} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - uploadId: uploadId parameter. |
Usage guide
## Mux Video API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create a Mux access token and secret in the Mux dashboard. Use HTTP Basic authentication with the token ID as the username and token secret as the password. Store both values as server-side secrets and use HTTPS. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Mux Video API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.