Skip to main content
Deleting a media item soft-deletes it: the row is marked deleted (is_deleted) and the underlying S3 file is retained, so nothing is permanently destroyed at this step. You can restore it later from Settings → Archive.
1

Open the Library tab

Open the Media Library modal from any image picker and stay on the Library tab.
2

Open the item's menu

Click the menu on the tile.
3

Choose Archive

The item is soft-deleted and removed from the library grid.
Archiving a media item requires the Edit shared assets permission.

Restore an archived item

Soft-deleted media stays recoverable. Go to Settings → Archive, filter by Media, and restore the item to return it to the library.

What references see

Anything that referenced the deleted item — a widget image, a report cover, or a branding logo — shows a broken image until you edit it and pick a different file.

API

DELETE /v1/media/{id} soft-deletes a single item. It returns 404 if the item doesn’t exist (or is already deleted) in your account.