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

# Delete a playlist

`DELETE /v1/playlists/{id}`

## Request

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

Delete a playlist to the recycle bin. Screens assigned to it fall back to their default content. Fails with 409 if the playlist is shared into other spaces, unless the deletion is forced.

Moves the playlist to the recycle bin (restorable for 30 days).

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

## 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 playlist 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/02fd3665dc7d?raw)