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

# Bulk delete

> Soft-delete multiple media items at once.

Bulk delete is the fastest way to clear out leftover screenshots, duplicate uploads, or files from an offboarded client.

<Warning>
  Media is **soft-deleted** — each row is marked deleted (`is_deleted`) and the underlying S3 file is retained. Anything that references a deleted item shows a broken image until you point it at a different file. Review references first if you're removing a file currently in use.
</Warning>

## In the Media Library

<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="Select items">
    Check the checkbox on each tile you want to remove. Selecting two or more enables the bulk action.
  </Step>

  <Step title="Archive">
    Click **Archive (N)** to soft-delete the selected items.
  </Step>
</Steps>

<Note>
  Bulk archiving requires the **Edit shared assets** permission. Uploading and selecting media are open to all roles.
</Note>

Archived items are recoverable from **Settings → Archive** — filter by **Media** and restore.

## API

`DELETE /v1/media/bulk` with an `ids` array soft-deletes those items. Only items in your account are affected.