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
-
Send a PATCH request to this endpoint, replacing
{mediaId}with the media ID. -
Provide the desired
mp4Supportvalue in the request body. -
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– The media will have mp4 renditions up to 4K resolution. -
audioOnly– The media will generate an m4a file containing only the audio track. -
audioOnly,capped_4k– The media will have 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 will generate an MP4 rendition of the video up to 4K resolution, making it available for download via 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 will provide an audio-only stream URL that allows users to listen to the media without video.
By setting "mp4Support": "audioOnly,capped_4k", both options will be enabled. Users will be able to download the MP4 video and also stream just the audio version of the media.
Related guide: Use MP4 support for offline viewing