For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
StatusSupportDiscussionsLog inSign Up
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
  • ACTIVATE ACCOUNT
    • Create account
  • PRODUCT OS API
    • Overview
  • ERROR CODES
    • Error codes
  • VIDEO ON DEMAND API
    • Overview
      • GETGet list of all media
      • GETGet all clips of a live stream
      • GETGet a media by ID
      • DELDelete a media by ID
      • PATCHUpdate a media by ID
      • POSTAdd audio / subtitle track
      • PUTCancel ongoing upload
      • DELDelete audio / subtitle track
      • PATCHUpdate audio / subtitle track
      • POSTGenerate track subtitle
      • GETGet the summary of a video
      • PATCHUpdate the source access of a media by ID
      • PATCHUpdate the mp4Support of a media by ID
      • GETGet info of media inputs
      • GETGet all unused upload URLs
      • GETGet all clips of a media
  • LIVE STREAM API
    • Overview
  • VIDEO DATA API
    • Overview
LogoLogo
StatusSupportDiscussionsLog inSign Up
VIDEO ON DEMAND APIManage videos

Delete audio / subtitle track

DELETE
https://api.fastpix.com/v1/on-demand/:mediaId/tracks/:trackId
DELETE
/v1/on-demand/:mediaId/tracks/:trackId
$curl -X DELETE https://api.fastpix.com/v1/on-demand/4fa85f64-5717-4562-b3fc-2c963f66afa6/tracks/4fa85f64-5717-4562-b3fc-2c963f66afa6 \
>     -u "<username>:<password>"
200Deleted
1{
2  "success": true
3}
This endpoint allows you to delete an existing audio or subtitle track from a media file. Once deleted, the track must no longer be available for playback. #### How it works 1. Send a DELETE request to this endpoint, replacing `{mediaId}` with the media ID, and `{trackId}` with the ID of the track you want to remove. 2. The track gets deleted from the media file, and you must receive a confirmation response. #### Webhook events 1. After successfully deleting a track, your system must receive the webhook event **video.media.track.deleted**. 2. Once the media file is updated to reflect the track removal, a <a href="https://docs.fastpix.io/docs/media-events#videomediaupdated">video.media.updated</a> event must be triggered. #### Example Suppose you uploaded an audio track in Italian for a video but later realize it's incorrect or no longer needed. By calling this API, you can remove the specific track while keeping the rest of the media file unchanged. This is useful when: - A track was mistakenly added and needs to be removed. - The content owner requests the removal of a specific subtitle or audio track. - A new version of the track gets uploaded to replace the existing one. Related guides: <a href="https://docs.fastpix.io/docs/manage-subtitle-tracks">Add own subtitle tracks</a>, <a href="https://docs.fastpix.io/docs/manage-audio-tracks">Add own audio tracks</a>
Was this page helpful?
Previous

Update audio / subtitle track

Next
Built with

This endpoint allows you to delete an existing audio or subtitle track from a media file. Once deleted, the track must no longer be available for playback.

How it works

  1. Send a DELETE request to this endpoint, replacing {mediaId} with the media ID, and {trackId} with the ID of the track you want to remove.

  2. The track gets deleted from the media file, and you must receive a confirmation response.

Webhook events

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

  2. Once the media file is updated to reflect the track removal, a video.media.updated event must be triggered.

Example

Suppose you uploaded an audio track in Italian for a video but later realize it’s incorrect or no longer needed. By calling this API, you can remove the specific track while keeping the rest of the media file unchanged. This is useful when:

  • A track was mistakenly added and needs to be removed.
  • The content owner requests the removal of a specific subtitle or audio track.
  • A new version of the track gets uploaded to replace the existing one.

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.
trackIdstringRequiredformat: "uuid"
The unique identifier assigned to the media when created. The value must be a valid UUID.

Response

Delete a video media
successboolean
Demonstrates whether the request is successful or not.