Credits and Allowances
Credits pay for your agents’ work. Settings → Credits is where you see your balance, add credits, and set limits.
Your balance
Your plan includes credits each credit period: a month, aligned to your billing date. You can also buy more.
| Credits | What happens to them |
|---|---|
| Plan credits | Reset at the end of each credit period. Unused plan credits don’t carry over. |
| Purchased credits | Don’t expire. They’re used after your plan credits. |
Available credits are your balance minus credits held by work that’s still running. Every paid step an agent takes holds credits first, then settles to what it actually used.
How many credits a piece of work uses depends on the work: a short reply uses far fewer than a long research task. Cohort shows credits, not a dollar price per credit.
Adding credits
- Top up adds credits right away. The page shows how many credits each amount buys before you pay.
- Auto top-up adds credits when your balance falls below a level you choose, up to a monthly card limit you set.
- You’re notified when credits run low, and again if they run out. When they run out, paid work pauses until you add more.
Agent allowances
An allowance caps how many credits one agent can use in a credit period.
| Setting | What it does |
|---|---|
| Monthly allowance | The most credits the agent can use this credit period. It resets with your plan credits. |
| Pause at allowance (default) | The agent stops paid work when its allowance is used, and tells you why. It resumes next period, or as soon as an owner raises the allowance. |
| Notify only | You’re warned and notified, and the agent keeps working. |
| Warn at | A percentage (default 80%) at which you get a heads-up. |
Agents without an allowance share the workspace balance. New agents start without one.
Workspace daily cap
An optional cap on credits used across all agents in one day (UTC). Use it as protection against runaway work: paid work pauses for the rest of the day when the cap is reached.
Job limits and the conversation reserve
- Job limit: a single job (a task and the work it delegates) pauses at a set number of credits and asks before spending more. An owner or admin approves extra credits from the Credits page.
- Conversation reserve: when available credits fall to the reserve, optional background work (like scheduled routines) pauses so your conversations with agents keep working.
Permissions
| Role | View | Change allowances, caps and top-ups |
|---|---|---|
| Owner | Yes | Yes |
| Admin | Yes | Yes |
| Member | Yes | No |
From the API
Read your balance and usage, and set allowances, with the Credits API.