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: <a href="https://fastpix.com/docs/webhooks/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.
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.
- <b>Username:</b> Access Token ID
- <b>Password:</b> Secret Key
Activate your FastPix account to generate your API credentials. <a href="https://fastpix.com/docs/getting-started/activate-your-account" target="_blank">See the guide here</a>
Path parameters
mediaId
The unique identifier assigned to the media when created. The value must be a valid UUID.
Response
Delete a video media
success
Demonstrates whether the request is successful or not.