Update the mp4Support of a media by ID

This endpoint allows you to update the mp4Support setting of an existing media file using its media ID. You can specify the MP4 support level, such as none, capped_4k, audioOnly, or a combination of audioOnly, capped_4k, in the request payload.

How it works

1. Send a PATCH request to this endpoint, replacing {mediaId} with the media ID.

2. Provide the desired mp4Support value in the request body.

3. You receive a response confirming the update, including the media’s updated MP4 support status.

MP4 Support Options

• none – MP4 support is disabled for this media.

• capped_4k – Generates MP4 renditions up to 4K resolution.

• audioOnly – Generates an M4A file that contains only the audio track.

• audioOnly,capped_4k – Generates both an audio-only M4A file and MP4 renditions up to 4K resolution.

Webhook events

• video.media.mp4Support.ready – Triggered when the MP4 support setting is successfully updated.

Example

Suppose you have a video uploaded to the FastPix platform, and you want to allow users to download the video in MP4 format. By setting "mp4Support": "capped_4k", the system generates an MP4 rendition of the video up to 4K resolution, making it available for download through the stream URL(https://stream.fastpix.io/{playbackId}/{capped-4k.mp4 | audio.m4a}). If you want users to stream only the audio from the media file, you can set "mp4Support": "audioOnly". This provides an audio-only stream URL that allows users to listen to the media without video. By setting "mp4Support": "audioOnly,capped_4k", both options are enabled. Users can download the MP4 video and also stream just the audio version of the media.

Related guide: Use MP4 support for offline viewing