---
title: "List recalled content"
method: GET
path: "/v1/recall"
tags: ["recall"]
---

# List recalled content

`GET /v1/recall`

## Request

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

Return everything currently held off screens, including its kind, name, when it was recalled, and who recalled it. Since a recall is reversible, this list is the record of what is being withheld and why, so nothing stays off screens indefinitely without anyone knowing. An item is listed only where the caller can view that kind of content at its location. Who recalled it is returned in full only where the caller also holds the user view permission; otherwise only its kind, for example `user` or `staff`.

**Notes.**
- Newest first, not paginated. An item is listed only where the caller holds that kind's view permission (`media.view`, `playlist.view`, …) at its location; a `screen.view`-only key gets an empty list.

## Response `200`

Success.

- object
  - `data` object[], required
    - `kind` 'media' | 'creative' | 'playlist' | 'schedule', required
    - `id` string, required
    - `name` string, nullable, required
    - `recalledAt` string, required: ISO-8601 timestamp (UTC).
    - `recalledBy` string, nullable, required: An actor reference: `user:<id>`, `apikey:<id>`, `staff:<email>`, `partner:<email>` or `system…`. Without `user.view` at the item's location, only the kind (`user`, `staff`, …).

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