Skip to main content
DELETE

Overview

Deletes one image or video of your media library.
This cannot be undone. The media and its file are deleted. Projects already rendered are not affected, but the media can no longer be used in a new project.
What happens:
  • The media is deleted. Get Media answers 404 for it from then on, and it leaves List Media.
  • The storage its file used is given back to your team.
  • An import or upload that has not finished (PENDING or PROCESSING) can be deleted too: it stops, a file already sent is removed, and nothing is counted against your storage.
  • A media whose AI generation failed gives back the credits it was charged.

When it is refused

Nothing is deleted and the answer is 409 while:

Errors

Authorizations

x-api-key
string
header
required

Path Parameters

mediaId
string
required

The media id, from List Media, an import or an upload.

Response

Media deleted

success
boolean
message
string
data
object