---
title: "Delete a media asset"
method: DELETE
path: "/v1/media/{id}"
tags: ["media"]
---

# Delete a media asset

`DELETE /v1/media/{id}`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/media/{id}`
- Auth: HTTP bearer

Move a media asset to the recycle bin. Playlists and screens that reference it show a gap where the asset was until it is restored or replaced.

Moves the asset to the recycle bin (restorable for 30 days) and removes it from every playlist. Screens casting it return to their schedule.

## Path parameters

- `id` string, required

## Query parameters

- `force` 'true'

## Response `200`

Success.

- object
  - `data` object, required
    - `id` string, required
    - `deleted` true, required
    - `sharesRemoved` integer, required: Shares removed with it.

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `404`: No such asset in this workspace.
- `409`: `content_shared`: the item is shared into other places; `shareCount`, `crossSpaceShares`, `contentShares` say where. Repeat with `?force=true` to delete it and those shares.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/7c2741bcdb16?raw)