---
title: "Delete billing group"
method: DELETE
path: "/v1/billing-groups/{id}"
tags: ["billing-groups"]
---

# Delete billing group

`DELETE /v1/billing-groups/{id}`

## Request

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

Soft-deletes a billing group. Returns 409 if any screens are still billed to it; move or remove those screens first.

## Path parameters

- `id` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `id` string, required
    - `deleted` true, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: You do not hold the permission for the whole workspace (a grant at one location is not enough).
- `404`: No such group.
- `409`: `group_in_use`: screens still bill to it; move them first (`PATCH /v1/screens/:id` `billingGroupId`).
- `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)