---
title: "List the recycle bin"
method: GET
path: "/v1/recycle-bin"
tags: ["recycle-bin"]
---

# List the recycle bin

`GET /v1/recycle-bin`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/recycle-bin`
- Auth: HTTP bearer

List every deleted item across your workspace, including media, playlists, schedules, layouts, creatives, apps, and data sources. Each entry includes the deletion time and size, so items can be restored or permanently erased within the 30-day recovery window. Deleted screens are not included; screens have their own recovery endpoints.

**Notes.**
- Items deleted in the last 30 days, newest first. Each kind is listed only if the caller holds its view permission (`playlist.view`, `media.view`, …) where the item lives; a `screen.view`-only key sees only screens.

## Response `200`

Success.

- object
  - `data` object[], required
    - `kind` 'screen' | 'playlist' | 'schedule' | 'layout' | 'creative' | 'app' | 'media' | 'signage' | 'data-source' | 'banner' | 'media-folder', required
    - `id` string, required
    - `name` string, required
    - `deletedAt` string, required: ISO-8601 timestamp (UTC).
    - `nodeId` string, nullable, required
    - `sizeBytes` integer, required: Stored bytes (media); 0 for other kinds.
    - `usageBeforeDelete` integer, required: How many places used it when it was deleted.
    - `thumbnailUrl` string, nullable, required: For media: its stored address (may be an internal `r2://` reference, not a public URL).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `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)