---
title: "Check if content is too heavy for screens"
method: POST
path: "/v1/screens/heavy-check"
tags: ["screens"]
---

# Check if content is too heavy for screens

`POST /v1/screens/heavy-check`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/screens/heavy-check`
- Auth: HTTP bearer

Compares the load of one piece of content (videos that decode at the same time, web zones, 4K video) with what each screen can play (memory, measured device limits and the screen's own media self-test). Leave out `screenIds` to check the screens that show the content now. This is read-only: it warns and never blocks an assignment.

Compares one piece of content's load (videos that decode at the same time, web zones, 4K video) with each screen's capability (memory band, measured device limits, its own media self-test). Omit `screenIds` to check the screens that show this content now. Read-only: it warns, it never blocks an assignment.

## Request body

- object
  - `screenIds` string[]
  - `contentKind` 'playlist' | 'schedule' | 'layout' | 'creative' | 'app' | 'media' | 'signage', required
  - `contentId` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `load` object, required
      - `concurrentVideos` integer, required
      - `webZones` integer, required
      - `has4kVideo` boolean, required
      - `layout` object, nullable, required: The heaviest layout's zone mix, checked against each screen's memory band. Null when the content has no layout or the check is not on for this workspace.
        - `zones` integer, required
        - `videoZones` integer, required
        - `webZones` integer, required
        - `video4kZones` integer, required
    - `screens` object[], required: Worst first.
      - `screenId` string, required
      - `name` string, required
      - `verdict` 'ok' | 'heavy' | 'too-heavy', required
      - `score` number, required
      - `decodersNeeded` integer, required
      - `decodersAvailable` integer, nullable, required: Null = no decoder limit on this device.
      - `message` string, nullable, required

## Other responses

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