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

cea76e85cdac

scoped-budgets

Update Scoped Budget

Update a scoped budget's label, limit, or period.

The scope and the provider narrowing are not editable: changing either would move the ceiling to a different identity while carrying its spend, which is a delete and a create, not an update.

patch/v1/scoped-budgets/{budget_id}

Path parameters

budget_idstring required

Request body

budget_duration_secinteger nullable
max_budgetnumber nullable
namestring nullable
reset_alignment'calendar_day' | 'calendar_week' | 'calendar_month' nullable

Response

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
reset_alignmentstring nullable required
scope_idstring required
scope_typestring required
updated_atstring required