---
title: "Set or clear the overall and/or per-category monthly caps"
method: PATCH
path: "/v1/billing"
tags: ["Billing"]
---

# Set or clear the overall and/or per-category monthly caps

`PATCH /v1/billing`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/billing`
- Auth: HTTP bearer

Provide any subset of the fields — only the ones present are changed. At least one is required. `plan: "free"` is the downgrade path (schedules the subscription cancellation; the plan drops when the period ends). Paid plans cannot be set here — use `POST /api/dodo/checkout`.

## Request body

- object
  - `monthlyLimit` integer, nullable: `null` removes the overall cap.
  - `monthlyLimitTransactional` integer, nullable
  - `monthlyLimitCampaign` integer, nullable
  - `monthlyLimitWorkflow` integer, nullable
  - `monthlyLimitInbound` integer, nullable
  - `plan` 'free': Downgrade only.

## Response `200`

Echoes back whichever fields were changed.

- object

## Other responses

- `401`: Missing or invalid API key.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)