Skip to navigation
VIDEO ON DEMAND APIManage videos

Add audio / subtitle track

This endpoint allows you to add an audio or subtitle track to an existing media file using its mediaId. You need to provide the track url along with its type (audio or subtitle), languageName and languageCode in the request payload. You can optionally provide a title for the track.

How it works

  1. Send a POST request to this endpoint, replacing {mediaId} with the media ID (uploadId or id).

  2. Provide the necessary details in the request body.

  3. Receive a response containing a unique track ID and the details of the newly added track.

Webhook events

  1. After successfully adding a track, your system must receive the webhook event video.media.track.created.

  2. Once the track is processed and ready, you must receive the webhook event video.media.track.ready.

  3. Finally, an update event video.media.updated must notify your system about the media’s updated status.

Example

Suppose you have a video uploaded to the FastPix platform, and you want to add an Italian audio track to it. By calling this API, you can attach an external audio file (https://static.fastpix.com/music-1.mp3) to the media file. Similarly, if you need to add subtitles in different languages, you can specify type: subtitle with the corresponding subtitle url, languageCode and languageName.

Related guides: Add own subtitle tracks, Add own audio tracks

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

  • Username: Access Token ID
  • Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

Path parameters

mediaIdstringRequiredformat: "uuid"
The unique identifier assigned to the media when created. The value must be a valid UUID.

Request

This endpoint expects an object.
tracksobjectRequired
Contains details about the track being added to the media file.

Response

Media details updated successfully
successbooleanOptional
Demonstrates whether the request is successful or not.
dataobjectOptional
Contains details about the track that was added or updated.