List budgets
Returns budgets visible to the current workspace, ordered by creation time with the newest first. Supports filtering by scope kind, scope target id, period, and active state, plus an optional free-text query that searches across denormalized target names via Typesense.
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. Server translates this into a Typesense
search over the denormalized scope_target_name and id fields on
the per-workspace {workspace_id}_budgets collection.