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.
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.
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.
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.
Field used to order the list. Unset orders by most-recently-updated.
Response
OK