multi-router.aidocs

Budgets & Spend Control

Status and UsageEnterprise

The Budgets page, status labels, and each budget's usage.

The Budgets page lists the organization's budgets with their spend and status for the current period, and each budget's usage page charts its spend over time. Amounts are in US dollars, with periods measured in UTC.

The Budgets page

Engineering · org_3Fh8Wq2LdK

All budgets

New budget
Status:
allnearingimminentcapped
Search budgets…
Total spend
$18,580
Effective limits
$28,500
Capped
1
Imminent
0
Nearing
1
Unpriced traffic
0.4%
Budgets
1–5 of 525 / page
ColumnsUpdated
NameScopePeriodSpend / effective limitUsedStatusUpdated
Production API
bdg_7Qm2Xc9LpR
Tag · productionMonthly
$4,310/$5,000
86%Nearing2h ago
Production APIbdg_7Qm2Xc9LpRTag · productionMonthly
Detailed usage →
Spent
$4,310
Effective limit
$5,000
Remaining
$690
Per-router limit
$2,000base
Period
Sep 1 – Sep 30resets Oct 1
Pending requests
0
Routers over cap
0 of 4
Spend per day · daily · Sep 1 – Sep 30
SpendEffective limit/day
$0$100$200$300$400
Effective $166.67/day
Sep 1
Sep 8
Sep 15
Sep 22
Sep 29
Request approvers
Requests on
Emailed when someone asks for a higher limit in the Portal. The Portal hides its request button while this list is empty.
priya@example.com
name@example.com
Add
1 of 10
Budget Overrides · this period
Sep 1 – Sep 30 · UTC. Each override replaces one limit until the period ends.
Add Budget Override
TargetBase limitEffective limitChangeSet by
No Budget Overrides this period. Every limit is at its base.
Pending requests
Approving creates a Router override for this period. Adjust the amount before approving.
No pending requests.
Standard Engineering · claude-codePolicy1 request
bdg_2Lk5Pz8NcV
Tag · policy:standard-engineeringMonthly
$288/$200 per router
—No cap1d ago
Support routers
bdg_9Bv3Rt6YfJ
Routers · 3Monthly
$1,500/$1,500
100%Capped3d ago
Engineering org
bdg_4Hn8Ws1KdT
OrgMonthly
$11,842/$20,000
59%On track6d ago
Research sandbox
bdg_6Tx1Jm4GqW
Routers · 1Lifetime
$640/$2,000
32%Lifetime12d ago
Limits are server-resolved effective limits for the current UTC period.
The Budgets page with a budget open: status tiles, budgets of each scope, and the open budget's spend, approvers and overrides. Select to enlarge.

Tiles across the top show Total spend, Effective limits, and how many budgets are Capped, Imminent and Nearing, with the share of Unpriced traffic. The rail filters by status, overrides, pending requests, Managed by policy and scope. The table lists each budget's Name, Scope, Period, Spend / effective limit, Used, Status and when it was Updated. Opening a row shows Spent, Effective limit, Remaining, its limits, Period, Pending requests and Routers over cap, with its overrides and approvers.

Status

Each budget has a status for the current period:

StatusMeaning
On trackSpend is on pace to stay under the total cap.
OverSpend is at or above the total cap, with no Block rule holding.
NearingAt the current pace, spend reaches the total cap before the period ends.
ImminentSpend is at 90% of the total cap, or projected to reach it within the longest projection window of the budget's rules, or 30 minutes.
CappedA Block rule is holding.
No capThe budget has no total cap. Its router and model caps and their rules still apply.
LifetimeThe budget never resets.
Check tagA tag rule matches no routers.
UnavailableSpend could not be read just now.

Usage

Detailed usage on a budget's row opens its usage page. It shows Spent, Effective limit, Remaining, Used, Period and Resets, a Spend over time chart by hour or day or cumulative against the limit, spend by router with each router's share, and the top models by spend.

Spend and request logging

Spent, the Spend column and the tiles count every request. The usage chart, the router table and the model breakdown come from request records, so they include a router's requests when the router records them; for routers set to log failures only or nothing, the breakdowns add up to less than Spent. See Request Logging.

Overrides and RequestsWhen a Budget Blocks
Was this helpful?