Spend Limits
Spend limits protect against runaway usage by capping monthly organization spend in USD cents. Organization owners and admins can view the current cap and spend, request an increase, and approve or reject pending increase requests.Base URL
Endpoints
Get spend limit
Response
$1,000.00 and the current spend is $423.50.
Request a spend-limit increase
Request body
Response
amount must be greater than 0 USD cents.
Approve an increase request
Request body
amount is omitted, the pending request amount is used. The organization’s monthly_usd_cap is increased by the approved amount and the request status becomes approved.
Response
Reject an increase request
Response
Check balance
Response
available_balance is total_balance - current_month_spend.
Behavior when the cap is reached
Whencurrent_month_spend reaches monthly_usd_cap, the gateway rejects new requests with 429 Too Many Requests and a budget_exceeded detail. In-flight runs are allowed to finish.
Error codes
Related pages
- Service accounts — automate spend monitoring
- Access tokens — CLI authentication