OpenAPI 3.1.0raw.githubusercontent.com2026-08-19127156517.1 KB

3945cde96091

scoped-budgets

Create Scoped Budget

Create a scoped budget.

Answers 404 when the scope names nothing, rather than creating a ceiling that can never bind.

post/v1/scoped-budgets

budget_duration_secinteger nullable

Period length in seconds (e.g. 86400 for daily); null never resets

max_budgetnumber nullable

Maximum USD spend in the period

namestring nullable

Admin-facing label for the budget

provider_key_idstring nullable

Narrow the cap to one provider instance; null caps spend across every provider

scope_idstring required

Id of the capped identity: an organization, workspace, membership row, or API key

scope_type'organization' | 'workspace' | 'workspace_member' | 'org_member' | 'api_token' required

Which kind of identity this ceiling caps

Successful Response

budget_duration_secinteger nullable required

created_atstring required

current_spendnumber required

idstring required

max_budgetnumber nullable required

namestring nullable required

period_endstring nullable required

period_startstring nullable required

provider_key_idstring nullable required

reserved_spendnumber required

scope_idstring required

scope_typestring required

updated_atstring required