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 a media by ID

DELETE
https://api.fastpix.com/v1/on-demand/:mediaId
DELETE
/v1/on-demand/:mediaId
$curl -X DELETE https://api.fastpix.com/v1/on-demand/4fa85f64-5717-4562-b3fc-2c963f66afa6 \
>     -u "<username>:<password>"
200Deleted
1{
2  "success": true
3}
This endpoint allows you to permanently delete a a specific video or audio media file along with all associated data. If you wish to remove a media from FastPix storage, use this endpoint with the `mediaId` (either `uploadId` or `id`) received during the media's creation or upload. #### How it works 1. Send a DELETE request to this endpoint. Replace `<mediaId>` with the `uploadId` or the `id` of the media you want to delete. 2. This action is irreversible. Make sure you no longer need the media before proceeding. Once deleted, the media can’t be retrieved or played back. 3. Monitor the following webhook event: <a href="https://docs.fastpix.io/docs/media-events#videomediadeleted">video.media.deleted</a> #### Example A user on a video-sharing platform decides to remove an old video from their profile, or suppose you're running a content moderation system, and one of the videos uploaded by a user violates your platform's policies. Using this endpoint, the media is permanently deleted from your library, ensuring it's no longer accessible or viewable by other users.
Was this page helpful?
Previous

Update a media by ID

Next
Built with

This endpoint allows you to permanently delete a a specific video or audio media file along with all associated data. If you wish to remove a media from FastPix storage, use this endpoint with the mediaId (either uploadId or id) received during the media’s creation or upload.

How it works

  1. Send a DELETE request to this endpoint. Replace <mediaId> with the uploadId or the id of the media you want to delete.

  2. This action is irreversible. Make sure you no longer need the media before proceeding. Once deleted, the media can’t be retrieved or played back.

  3. Monitor the following webhook event: video.media.deleted

Example

A user on a video-sharing platform decides to remove an old video from their profile, or suppose you’re running a content moderation system, and one of the videos uploaded by a user violates your platform’s policies. Using this endpoint, the media is permanently deleted from your library, ensuring it’s no longer accessible or viewable by other users.

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.

Response

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