List budgets
Returns budgets visible to the current workspace, ordered by most recently updated with the newest first. Supports filtering by scope kind, scope target id, period, and active state, plus an optional free-text query that matches scope target names and ids. Requires a Management Key with the Budgets permission; project-scoped API keys cannot manage budgets.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Page size, 1–200. Unset uses the server default (25).
Cursor for forward pagination. Set to the budget_id of the last
item from the previous page.
Cursor for backward pagination. Set to the budget_id of the
first item from the previous page.
Optional filter: only return budgets whose scope kind matches one of the listed values. Empty means no scope-kind filter.
BUDGET_SCOPE_KIND_UNSPECIFIED, BUDGET_SCOPE_KIND_WORKSPACE, BUDGET_SCOPE_KIND_PROJECT, BUDGET_SCOPE_KIND_IDENTITY, BUDGET_SCOPE_KIND_API_KEY, BUDGET_SCOPE_KIND_PROVIDER, BUDGET_SCOPE_KIND_MODEL Optional filter: only return budgets whose scope target id matches.
Optional filter: only return budgets with this active state.
Optional filter: only return budgets whose limits.period matches one of the listed values. Empty means no period filter.
BUDGET_PERIOD_UNSPECIFIED, BUDGET_PERIOD_DAILY, BUDGET_PERIOD_WEEKLY, BUDGET_PERIOD_MONTHLY, BUDGET_PERIOD_YEARLY, BUDGET_PERIOD_ONE_TIME Optional free-text query matched against a budget's scope target name and id.
Field used to order the list. Unset orders by most-recently-updated.
BUDGET_SORT_FIELD_UNSPECIFIED, BUDGET_SORT_FIELD_EXPIRES_AT, BUDGET_SORT_FIELD_CREATED_AT, BUDGET_SORT_FIELD_UPDATED_AT