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

PATCH/v1/billing

Secret key — sk_… or sk_test_… · Base URL https://api.volanea.com

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.

Body

Required · application/json

monthlyLimitinteger | null
`null` removes the overall cap.
monthlyLimitTransactionalinteger | null
monthlyLimitCampaigninteger | null
monthlyLimitWorkflowinteger | null
monthlyLimitInboundinteger | null
planenum
Downgrade only.
free

Errors

Every failure returns the standard envelope — branch on `code`, never on the wording of `error`.

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

Request

curl https://api.volanea.com/v1/billing \
  -X PATCH \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "monthlyLimit": 1,
    "monthlyLimitTransactional": 1,
    "monthlyLimitCampaign": 1
  }'

Response

200 · application/json

{
  "success": true,
  "data": {}
}

92 endpoints · OpenAPI document