Delete media
media.deleteDestructiveIdempotent
Delete a media for good, so an old or wrong version stops turning up: its file here, proxy, mezzanine and media.analyze results go, and its room comes back to this account’s storage. A path import leaves the original in its folder; exports made from it stay. Timelines that use it keep their ids and edits but no longer render (media_offline names it, as for expired media): replace those clips with clip.replace. Importing the same file again makes a new media_id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media_id | Yes | Media handle from media.import or a create.* tool |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deleted | Yes | ||
| storage | Yes | ||
| media_id | Yes | Media handle from media.import or a create.* tool | |
| freed_bytes | Yes | What it held here: the file, its proxy and mezzanine, and its analyses |