ProliferateDocs
Join the beta

Usage & limits

See balances and consumption, configure limits, and understand the current model-spend caveats.

The Usage & limits pane shows usage attributed to your organization and lets an admin cap it — for managed-model spend, and only where a member's gateway enrollment attributes it to the org rather than to them personally.

Scope
WhoOwner or admin only — the pane is admin-only. Members see their own LLM usage in the app sidebar, not here
Applies toThe managed gateway — local work is not metered
PlanBilling enabled on the organization
AffectsThe organization and individual members

What the pane shows#

Balances, a consumption timeseries over the selected range, and a per-member usage drill-down — all live, reflecting usage attributed to the organization as above. This is the admin view of the whole organization; a member's own LLM meter lives in the app sidebar.

Configuring limits#

Each limit is one row. Add an organization-wide row that applies to everyone, or a per-member row for a single person.

Per row, set:

  • Resource — LLM spend, capped in USD.
  • Window — Daily or Monthly.
  • Cap — the amount for that window.
  • Enabled — a per-row switch; a disabled row is kept but not applied.

Rows take effect when you Save.

Enforcement#

Every applicable enabled limit is evaluated in its own UTC daily or monthly window. Reaching any applicable limit blocks that resource.

Org LLM limits are incomplete today. A configured LLM limit applies only to gateway usage attributed to the organization — not to all managed-gateway usage. Because normal enrollment can attribute spend to a member's personal subject rather than to a shared organization subject, treat org-level LLM budgeting as incomplete today. Usage on your own keys or gateway is outside it entirely.

Two details in how usage is attributed are why:

  • Normal agent authentication renders a member's personal model-gateway enrollment, not the organization's, so gateway spend is attributed to the member rather than to a shared organization subject.
  • Which organization a member's usage lands against resolves through the server's current membership, not the org selected in Desktop, so for a member in more than one organization it can attribute to a different org than expected.
Note

The pane manages and stores these limit rows and evaluates them per window. It does not change what a member's own provider keys or a bring-your-own gateway allow. See Model gateways.

What members see when blocked#

When a session can't start for a billing reason, the banner names the cause instead of a generic error:

What members seeWhat it means
Model gateway unavailableGateway-routed model calls are unavailable or have reached their configured budget.
Payment or account needs attentionManaged access is paused until the account issue is resolved.

The member-facing walkthrough of these states is Billing issues.