Billing & usage
Read your credit balance, see where model spend went, and add credits.
Two console pages answer "what did this cost, and who spent it".
Analytics charts metered tokens and cost, and is always available — including on a self-hosted stack with no billing service, where it reports what your own daemons metered. Billing holds the prepaid credit balance and the ledger behind it, and appears only on deployments that run a billing service.
The two do not cover the same money. Analytics reports everything metered, and agents on daemons you connect yourself use the provider credentials configured on those machines — that traffic is counted but never billed. Only metered Cloud work draws down the balance. See Cloud pricing for the rates and what running out of credits does.
Billing
Balance
The balance card is the number Cloud work draws down, with the state of the organization beside it:
- Serving — placements are taking model traffic normally.
- Suspended — the balance is exhausted and Cloud placements have stopped taking new model traffic. Adding credits resumes them.
- Unconfirmed — a change to the organization's access has not been confirmed upstream yet, so AgentConnect does not claim either way. This is not a payment state and it resolves on its own.
Add credits
Owners see Add credits, which opens a Stripe checkout for the amount entered. Every member can read the balance and the ledger; only owners can top it up. A completed purchase offers a Receipt link on its ledger row once the receipt is available, which can be a moment after the payment itself completes.
If you leave the Stripe page without paying, nothing is charged. A payment that is still settling shows as pending rather than failed — it resolves on its own, and has its own banner separate from the balance state above.
Activity
The Activity chart buckets the ledger over the last 24h, 7d, 30d, or 90d, in your own time zone, and switches between Usage and Top-ups. Use it to see when spend happened rather than what it was for; Analytics answers what.
Transactions
The Transactions table lists the ledger newest first, filtered to Usage or Top-ups, and loads more as you page through it. Credit rows carry a kind — Credit purchase, Adjustment, Promotional credit, or Refund — and an adjustment may include a note from whoever recorded it.
Usage rows name the agents that spent the money, as chips with each one's share. Names follow your access to the Agent itself, as on the Agents page. Owners can see every current organization Agent; other members see Agents allowed by Team visibility. Hidden or deleted Agents fold into a single unnamed rollup with no agent count, shown separately from the +N overflow for named chips. Session audiences do not change this billing attribution.
Analytics
Analytics charts tokens and cost over the last 24 hours, 7 days, 30 days, or 90 days, grouped By agent, By runtime, or By model. On a narrow screen the 90-day range is not offered. Selecting a series in the legend hides it and selecting it again brings it back, so you can take noisy series out of the picture.
Where the deployment runs a daemon pool, a source filter picks which ingress metered the session:
- All — everything, billed or not.
- Cloud — sessions metered by the managed pool. These are the ones that draw down credits.
- Cluster — the same filter on a self-hosted deployment: sessions metered by the pool your own deployment runs, using its model access. Counted here, with no AgentConnect balance behind them.
- Daemons — sessions metered by a daemon you connect. Counted here, never billed.
Source is recorded when the session runs, so moving an agent between a daemon and the pool changes where its future usage lands without rewriting its history.
Who sees what
| Capability | Owner | Other members |
|---|---|---|
| Read the balance, Activity, and Transactions | ✅ | ✅ |
| Read organization-wide Analytics totals and source totals | ✅ | ✅ |
| See Analytics agent/model breakdowns and spend over time | Complete organization usage | Only usage from Agents and Sessions they can access |
| See an agent named on a billing usage row | All current organization Agents | Only Agents they can see |
| Add credits | ✅ | ❌ |
Owners receive complete Analytics attribution, including spend from restricted Agents, another member's Private session, or a provider-restricted session. The aggregates do not include session IDs, titles, transcripts, or tool details. Reading a session still requires its own session audience.
For Collaborators and Viewers, Analytics attribution requires access to both the Agent and the Session. Withheld spend stays in the organization total and appears as Restricted usage. Attributed agent rows plus that rollup equal the total. Their spend chart includes only attributed usage, so it may sum to less than the organization total. Source totals remain organization-wide for every role.
For example, an Agent with $4 of shared-session spend and $7 from another member's Private session contributes $11 to the organization total. An Owner sees all $11 attributed to that Agent. A Collaborator who can access the Agent and only the shared session sees $4 attributed and $7 as unattributed usage.
How is this guide?