Media Service

Request video master file generation

POST

https://api.typeform.com/media/videos/{id}/master

Initiates the master file generation process for a video. This should be called after uploading a video file.

Master File Process:

  1. After uploading a video to the upload_url, call this endpoint to start processing
  2. The service will begin generating the master file (high-quality downloadable version)
  3. Use the GET endpoint to poll for status and retrieve the download URL when ready

Note: This endpoint is idempotent - calling it multiple times for the same video will not restart processing.

Request

Path Parameters

Parameter Type Required Description
id string Yes Unique ID for the video returned from the upload endpoint

Responses

Status

200 Master file generation request accepted

Schema

Property Type Description
status string Valid values: none, preparing, ready
url string Download URL for the processed media file. Present only when status is "ready". Temporary signed URL to be used promptly.

Current transcoding status:

  • none: No master file has been requested
  • preparing: Upload being prepared
  • ready: Processing complete, media available for download

Example

{
  "status": "ready",
  "url": "https://stream.mux.com/video-id/high.mp4?token=signed-token"
}

Status

401 Unauthorized - invalid or missing authentication token

Schema

Property Type Description
code string Error code identifying the type of error
details object Additional error details specific to the error type
message string Human-readable error message

Status

404 Video not found

Schema