Create or update a workspace budget
Create or update the budget for a given interval. Budget limits must strictly decrease as the interval narrows (lifetime > monthly > weekly > daily). The optional include_byok_in_budgets flag is a workspace-wide setting: when provided it applies to every budget interval for the workspace, not just the interval in this request. Note that a change made here is applied to budget enforcement immediately, but an already-open workspace settings page in the web dashboard may keep showing the previous value until it is reloaded. Management key required.
Authorizations
API key as bearer token in Authorization header
Path Parameters
The workspace ID (UUID) or slug
1"production"
Budget reset interval. Use "lifetime" for a one-time budget that never resets.
daily, weekly, monthly, lifetime "monthly"
Body
Spending limit in USD. Must be greater than 0.
100
Whether to include BYOK (bring-your-own-key) spend when enforcing the workspace's budgets. This is a workspace-wide setting: it applies to every budget interval (daily, weekly, monthly, and lifetime), not just the interval being upserted in this request. Omit to leave the current setting unchanged.
true
Response
Budget created or updated successfully
The created or updated budget
Whether BYOK (bring-your-own-key) spend is included when enforcing the workspace's budgets. This is a workspace-wide setting that applies to all budget intervals (daily, weekly, monthly, and lifetime).
true