Get Budget Exhaustion Rate
GET /api/v1/admin/costs/budget-exhaustion-rate
GET
/api/v1/admin/costs/budget-exhaustion-rate
Return rolling per-role budget exhaustion rate.
Aggregates the cross-tenant decisions table over a rolling
window (default 24h, max 168h / 1 week). A decision is “exhausted”
when tool_calls_used >= tool_calls_max OR
reflection_rounds_used >= reflection_rounds_max.
Alerting: alerting=True iff rate_pct > 5.0 AND
executions >= 20 (small-sample guard prevents 1-of-1 false
positives from tripping the rule at 100%).
Authorizations
Parameters
Query Parameters
window_hours
integer
Responses
200
Successful Response
Frozen response shape for the budget-exhaustion-rate endpoint.
object
alert_threshold_pct
required
number
computed_at
required
string
min_sample
required
integer
rates
required
Array<object>
One row of the per-role budget exhaustion rate breakdown.
object
alerting
required
boolean
executions
required
integer
exhausted
required
integer
rate_pct
required
number
role
required
string
window_hours
required
integer
422
Validation Error
object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string