> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oviond.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete media

> Soft-delete a single media item.

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**.

<Steps>
  <Step title="Open the Library tab">
    Open the **Media Library** modal from any image picker and stay on the **Library** tab.
  </Step>

  <Step title="Open the item's menu">
    Click the `⋯` menu on the tile.
  </Step>

  <Step title="Choose Archive">
    The item is soft-deleted and removed from the library grid.
  </Step>
</Steps>

<Note>
  Archiving a media item requires the **Edit shared assets** permission.
</Note>

## 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.