Skip to the page

Set spending limits (owner or billing manager)

PUT/v1/organisations/{id}/billing/limits

Operation billing.limits · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

Owners and billing managers.

Path parameters

idstring (uuid)required
The organisation id.

Body (JSON)

budgetMonthlynumber or nullrequired
A monthly budget to be warned at, or null.
budgetAlertRationumber, 0.1 to 1optional
The share of the budget that warns (default 0.8).
hardLimitMonthlynumber or nullrequired
A monthly limit nothing may go past, or null.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:

  • not_owner
PUT/v1/organisations/{id}/billing/limits
curl -X PUT "https://api.rykloud.com/v1/organisations/$ORG_ID/billing/limits" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "budgetMonthly": 200,
  "budgetAlertRatio": 0.8,
  "hardLimitMonthly": 300
}'