Media Service

Request audio master file generation

post

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

Initiates the master file generation process for an audio file. This should be called after uploading an audio file.

Master File Process:

After uploading an audio file 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 audio will not restart processing.

string, required

Unique ID for the audio 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 Audio 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