---
title: "Switch billing mode"
method: POST
path: "/v1/account/billing-mode"
tags: ["account"]
---

# Switch billing mode

`POST /v1/account/billing-mode`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/account/billing-mode`
- Auth: HTTP bearer

Switches the workspace between automatic card charging (`auto`) and invoice billing (`invoice`). Switching to invoice billing requires a signed-in user with a verified work email address, so an API key can only switch to automatic charging.

## Request body

- object
  - `mode` 'auto' | 'invoice', required

## Response `200`

Success.

- object
  - `data` object, required
    - `mode` 'auto' | 'invoice', required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: `user_required`: switching to `invoice` needs a signed-in user with a verified work email, so an API key can switch only to `auto`. Also: You do not hold the permission for the whole workspace (a grant at one location is not enough).
- `409`: `email_unverified`, `work_email_required`, `billing_not_configured`, or `under_contract`.
- `422`: `mode` is not `auto` or `invoice`.
- `502`: The billing provider did not answer; nothing changed.
- `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)