---
title: "Set what many screens play"
method: POST
path: "/v1/screens/bulk-assign"
tags: ["screens"]
---

# Set what many screens play

`POST /v1/screens/bulk-assign`

## Request

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

Assign one piece of content to many screens in a single request. The content is validated the same way as in the single-screen assign endpoint. Screen IDs outside your access scope or belonging to another workspace are dropped; screens at locations not shared with the content are skipped and counted in the response. This action is recorded as a single entry in the activity log.

Assigns one piece of content to many screens. Unknown or out-of-reach screen ids are silently dropped; screens whose location the content is not shared to are skipped and counted in `notShared`; screens under an approval policy the content was not reviewed by are skipped and counted in `needsApproval` unless the caller holds the content kind's approve permission there.

## Request body

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

## Response `200`

Success.

- object
  - `data` object, required
    - `updated` integer, required
    - `notShared` integer, required
    - `needsApproval` integer, required
    - `screenIds` string[], required: The screens actually assigned.

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `404`: No such content.
- `422`: Empty/oversized `screenIds`, invalid kind, or unplayable content.
- `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)