Skip to main content
PATCH
Change your team's daily cap or overage budget
An absent field stays, and each keeps its value while off. Each change is recorded in your team’s audit log. A change holds from the next run: at the cap, new runs are refused with quota_exceeded until the UTC day resets, and runs already started finish.
  • Owners and Admins only. An API key needs team:manage.
  • daily_cap: calls a UTC day, or overage_cents, overage dollars a UTC day in US cents. Dollars stay as set; each UTC day they come to that day’s included calls plus the dollars over that day’s overage price, rounded down. A cap in dollars needs billing terms with an overage price. A cap may be below the included calls. Only runs count; builds never do.
  • overage_budget: cents of overage each billing period, at least 1, which budget alerts measure against. It never stops runs.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: team:manage; an API key also needs team:manage.
  • Effect: Creates or changes something.
  • Errors: business_account_required, role_permission_missing, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
daily_cap
object
overage_budget
object

Response

Your team's spend controls

daily_cap
object
required

Kept while off

overage_budget
object

Owners and Admins only. Kept while off

today
object

Absent while they can't be counted