Mux

Mux Assets API

An asset refers to a piece of media content that is stored or is being live streamed through the Mux system. An asset always has a duration and one or more tracks (audio, video, and text data). The media content of an asset cannot be updated once created, however an asset can be used to create another asset, and can be modified within that process.

GitHub OpenAPI
Business capability
Media Asset Management BC-3710

Operations 17

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /video/v1/assets List video assets · List assets #
Ask an LLM
“Which video assets are in my Mux environment?”
“Can I page through all my uploaded videos?”
Tell an agent
List my video assets.
List video assets page {page}, {limit} per page.
POST /video/v1/assets Create a video asset · Create an asset #
Ask an LLM
“How do I create a new video asset in Mux from a file?”
“What's the call to ingest a new video so it becomes an asset?”
Tell an agent
Create a new video asset.
Ingest a new video and make it an asset.
GET /video/v1/assets/{ASSET_ID} Get a video asset's details · Retrieve an asset #
Ask an LLM
“Is my video asset ready to play yet?”
“What details can I see for one video asset?”
Tell an agent
Show me asset {asset_id}.
Check the status of video asset {asset_id}.
PATCH /video/v1/assets/{ASSET_ID} Update a video asset · Update an asset #
Ask an LLM
“Can I change settings on a video asset after it's created?”
“How do I edit an existing asset's details?”
Tell an agent
Update asset {asset_id}.
Edit the settings of video asset {asset_id}.
DELETE /video/v1/assets/{ASSET_ID} Delete a video asset · Delete an asset #
Ask an LLM
“How do I permanently delete a video from Mux?”
“Can I remove an asset I no longer need?”
Tell an agent destructive · confirm first
Delete asset {asset_id}.
Permanently remove video asset {asset_id}.
GET /video/v1/assets/{ASSET_ID}/input-info See the inputs used to create an asset · Retrieve Asset Input Info #
Ask an LLM
“What source files and input settings were used to build this asset?”
“Can I check which input settings were applied when an asset was created?”
Tell an agent
Show the input info for asset {asset_id}.
List the source inputs and their settings for asset {asset_id}.
POST /video/v1/assets/{ASSET_ID}/playback-ids Add a playback ID to an asset · Create a Playback ID #
Ask an LLM
“How do I get a new playback ID so viewers can stream my asset?”
“Can I add a signed or DRM playback ID to an existing asset?”
Tell an agent
Add a playback ID to asset {asset_id}.
Create a {policy} playback ID on asset {asset_id}.
GET /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID} Get an asset's playback ID details · Retrieve a Playback ID #
Ask an LLM
“What policy is set on a particular playback ID of my asset?”
“Can I look up one playback ID belonging to an asset?”
Tell an agent
Show playback ID {playback_id} on asset {asset_id}.
Check the policy of asset {asset_id}'s playback ID {playback_id}.
DELETE /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID} Remove a playback ID from an asset · Delete a Playback ID #
Ask an LLM
“How do I stop people watching an asset through one specific playback ID?”
“Does deleting an asset's playback ID cut off viewers already watching?”
Tell an agent destructive · confirm first
Delete playback ID {playback_id} from asset {asset_id}.
Revoke viewing access via playback {playback_id} on asset {asset_id}.
PUT /video/v1/assets/{ASSET_ID}/mp4-support Change MP4 support on an asset (deprecated) · Update MP4 Support #
Ask an LLM
“Can I still turn MP4 downloads on or off using the old mp4-support setting?”
“What replaced the deprecated MP4 support endpoint for assets?”
Tell an agent
Set MP4 support on asset {asset_id} to {mp4_support}.
Use the legacy mp4-support call to disable MP4 on asset {asset_id} with {mp4_support}.
PUT /video/v1/assets/{ASSET_ID}/master-access Enable temporary master file download · Update Master Access #
Ask an LLM
“How do I download the highest-quality master MP4 of my video?”
“How long does a master access download URL stay valid?”
Tell an agent
Set master access on asset {asset_id} to {master_access}.
Turn on the 24-hour master MP4 download for asset {asset_id} with {master_access}.
POST /video/v1/assets/{ASSET_ID}/static-renditions Create an MP4 static rendition for an asset · Create a Static Rendition for an Asset #
Ask an LLM
“Can I generate a downloadable MP4 of my asset at a specific resolution?”
“How do I add a static rendition to a video that already exists?”
Tell an agent
Create a {resolution} static rendition for asset {asset_id}.
Add a {resolution} MP4 rendition to asset {asset_id} tagged {passthrough}.
DELETE /video/v1/assets/{ASSET_ID}/static-renditions/{STATIC_RENDITION_ID} Delete one static rendition of an asset · Delete a Single Static Rendition for an Asset #
Ask an LLM
“How do I remove a single MP4 rendition from an asset without deleting the video?”
“Can I delete just one static rendition I created?”
Tell an agent destructive · confirm first
Delete static rendition {static_rendition_id} from asset {asset_id}.
Remove the MP4 rendition {static_rendition_id} on asset {asset_id}.
POST /video/v1/assets/{ASSET_ID}/tracks Add a subtitle or audio track to an asset · Create an Asset Track #
Ask an LLM
“How do I attach a subtitles file to a video that's already uploaded?”
“Can I add an alternate-language audio track to an asset?”
Tell an agent
Add a {type} track from {url} in {language_code} to asset {asset_id}.
Attach subtitles from {url} in {language_code} named {name} to asset {asset_id}.
DELETE /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID} Remove a text or audio track from an asset · Delete an Asset Track #
Ask an LLM
“How do I remove a subtitle track from my video?”
“Can I delete the primary audio or video track of an asset?”
Tell an agent destructive · confirm first
Delete track {track_id} from asset {asset_id}.
Remove the extra audio track {track_id} on asset {asset_id}.
PATCH /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID} Edit an existing asset track · Update an Asset Track #
Ask an LLM
“Can I rename a subtitle track or change its language after adding it?”
“How do I mark an existing text track as closed captions?”
Tell an agent
Rename track {track_id} on asset {asset_id} to {name}.
Change the language of track {track_id} on asset {asset_id} to {language_code}.
POST /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}/generate-subtitles Auto-generate subtitles from an audio track · Generate Track Subtitles #
Ask an LLM
“Can Mux auto-generate captions for a video I uploaded earlier?”
“How do I create subtitles from an asset's audio track after the fact?”
Tell an agent
Generate subtitles for audio track {track_id} on asset {asset_id} with {generated_subtitles}.
Auto-caption asset {asset_id} from audio track {track_id} using {generated_subtitles}.

Documentation

📖
Documentation
https://www.mux.com/docs/core/stream-video-files
📖
APIReference
https://www.mux.com/docs/api-reference
📖
Documentation
https://www.mux.com/docs/guides/start-live-streaming
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Live-Streams
📖
Documentation
https://www.mux.com/docs/core/monitor-your-video-streaming-performance
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Video-Views
📖
Documentation
https://www.mux.com/docs/guides/play-your-videos
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Streaming
📖
Documentation
https://www.mux.com/docs/guides/get-images-from-a-video
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Thumbnails
📖
Documentation
https://www.mux.com/docs/guides/mux-robots
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Jobs
📖
Documentation
https://www.mux.com/docs/guides/signing-jwts
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Signing-Keys

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mux-com/refs/heads/main/openapi/mux-com-assets-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mux-com:mux-com-assets-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mux-com-assets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mux Com Assets API
  version: v1
  description: 'Operations tagged Assets across 2 of this provider''s published API definitions: mux-com-openapi.yml, mux-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mux.com
  description: Mux production API
- url: https://image.mux.com
- url: https://stream.mux.com
- url: https://stats.mux.com
tags:


# --- truncated at 32 KB (71 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mux-com/refs/heads/main/openapi/mux-com-assets-api-openapi.yml