Skip to navigation

Delete a media by ID

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
successbooleanOptional
Demonstrates whether the request is successful or not.