---
title: "List API deprecations"
method: GET
path: "/v1/status/deprecations"
tags: ["status"]
---

# List API deprecations

`GET /v1/status/deprecations`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/status/deprecations`
- Auth: none required

List every API route scheduled for retirement, when it stops working, and its replacement. This endpoint requires no authentication and is safe to poll from a script. An empty list means no routes are currently scheduled for retirement.

## Response `200`

Success.

- object
  - `data` object, required
    - `noticeDays` integer, required: The minimum notice a retired route gets.
    - `policy` string, required
    - `deprecations` object[], required
      - `route` string, required: `METHOD /path`.
      - `announced` string, required: Date (`YYYY-MM-DD`) it was listed.
      - `sunset` string, required: Date (`YYYY-MM-DD`) it stops working.
      - `replacement` string, nullable, required
      - `why` string, required
      - `noticeDays` integer, required: Days between `announced` and `sunset`.

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `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)