---
title: "Set ad slot venues"
method: PUT
path: "/v1/ad-slots/{id}/venues"
tags: ["ad-slots"]
---

# Set ad slot venues

`PUT /v1/ad-slots/{id}/venues`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/ad-slots/{id}/venues`
- Auth: HTTP bearer

Set or clear the Vistar venue id of many screens at once. Send a list of `screenId` and `venueId` entries. A `venueId` of null clears the mapping. If any entry is not valid, nothing is saved and the response lists each problem.

## Path parameters

- `id` string, required

## Request body

- object[]
  - `screenId` string, required
  - `venueId` string, nullable, required: The Vistar venue id: letters, numbers, hyphen and underscore, up to 64. Null clears it.

## Response `200`

Success.

- object
  - `data` object, required
    - `changed` integer, required: Screens whose venue is now different.

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The `dooh` feature is off for this workspace (`feature_disabled`).
- `404`: No such ad slot in this workspace.
- `422`: An entry has an unknown screen or an invalid venue id. Nothing is saved; `errors` lists each entry.
- `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)