---
title: "Get retention settings"
method: GET
path: "/v1/account/retention"
tags: ["account"]
---

# Get retention settings

`GET /v1/account/retention`

## Request

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

Returns the workspace's data retention schedule: every data stream that can be governed, the retention window currently in effect for it, and the allowed range for that window.

## Response `200`

Success.

- object
  - `data` RetentionSchedule, required
    - `policy` object, required: Days kept per stream, only for the streams the workspace has set. An absent stream uses the platform window.
      - `offline` number
      - `screenshots` number
      - `playback` number
      - `deviceLogs` number
      - `vitals` number
      - `replays` number
      - `aiEvents` number
    - `effective` object, required: Days kept per stream now.
      - `offline` integer, required
      - `screenshots` integer, required
      - `playback` integer, required
      - `deviceLogs` integer, required
      - `vitals` integer, required
      - `replays` integer, required
      - `aiEvents` integer, required
    - `bounds` object, required
      - `offline` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required
      - `screenshots` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required
      - `playback` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required
      - `deviceLogs` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required
      - `vitals` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required
      - `replays` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required
      - `aiEvents` object, required
        - `min` integer, required
        - `max` integer, required
        - `platformDefault` integer, required
        - `label` string, required
        - `what` string, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: You do not hold the permission for the whole workspace (a grant at one location is not enough).
- `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)