---
title: "Set the fill playlist"
method: PUT
path: "/v1/shared-with-me/{allocationId}/fill"
tags: ["shared-with-me"]
---

# Set the fill playlist

`PUT /v1/shared-with-me/{allocationId}/fill`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/shared-with-me/{allocationId}/fill`
- Auth: HTTP bearer

Attach an existing playlist as the fill for an airtime slice reserved for the caller's team. Send `playlistId` as `null` to remove it.

**Notes.**
- Besides `playlist.view`, the caller needs `playlist.edit` at the location the slice is reserved for.

## Path parameters

- `allocationId` string, required

## Request body

- object
  - `playlistId` string, nullable, required: A playlist you can edit; null unbinds.

## Response `200`

Success.

- object
  - `data` object, required
    - `allocationId` string, required
    - `fillPlaylistId` string, nullable, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: You cannot fill this slice, or cannot edit that playlist.
- `404`: No such fillable slice, or no such playlist in this workspace.
- `422`: The playlist is the one the slice belongs to.
- `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)