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:

After uploading a video to the upload_url, call this endpoint to start processing
The service will begin generating the master file (high-quality downloadable version)
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.

string, required

Unique ID for the video returned from the upload endpoint

200 Master file generation request accepted

status

string

Valid values:nonepreparingready

Current transcoding status:

url

string

Download URL for the processed media file. Only present when status is "ready". This is a temporary signed URL that should be used promptly.

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

401 Unauthorized - invalid or missing authentication token

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

404 Video not found

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