Skip to main content
GET
Get media status
Read access: a read-enabled personal or team REST API key, or a signed-in user. OAuth clients use the corresponding MCP tool through /mcp. Read media preparation status and its metadata when ready. A processing result contains the state only. A ready result includes metadata. Failed video preparation returns an error instead of making media publishable. MCP clients can use get_media_status for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Posted REST API key

Path Parameters

mediaId
string<uuid>
required

The mediaId from the corresponding list, record or authorization response.

Response

Ready includes media metadata; uploading or processing returns only state.

state
string
media
object