---
title: "Create a fill playlist"
method: POST
path: "/v1/shared-with-me/{allocationId}/fill"
tags: ["shared-with-me"]
---

# Create a fill playlist

`POST /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

Create a new playlist and attach it as the fill for an airtime slice reserved for the caller's team.

**Notes.**
- Besides `playlist.view`, the caller needs `playlist.edit` at the location the slice is reserved for.
- The new playlist is empty and is placed at the reserved location.

## Path parameters

- `allocationId` string, required

## Request body

- object
  - `name` string: Default `<location> slice`.

## Response `200`

Success: A fill playlist is already bound: it is returned (`created: false`) and nothing is created.

- object
  - `data` object, required
    - `allocationId` string, required
    - `fillPlaylistId` string, required
    - `name` string, required
    - `created` boolean, required

## Other responses

- `201`: Success.
- `401`: Missing, expired or revoked bearer token.
- `403`: You cannot fill this slice.
- `404`: No such fillable slice in this workspace.
- `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)