---
title: "Delete an ad slot"
method: DELETE
path: "/v1/ad-slots/{id}"
tags: ["ad-slots"]
---

# Delete an ad slot

`DELETE /v1/ad-slots/{id}`

## Request

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

Delete an ad slot and stop it from requesting ads. Cached creatives and the record of impressions already played are kept, so past playback history remains available after the slot is removed.

**Notes.**
- Answers `{ ok: true }`. The slot is also disabled; its impressions are kept.

## Path parameters

- `id` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `ok` true, required

## 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 ad slot 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)
