Credit / quota issues
You see “Your workspace has run out of credits” or “You have reached your monthly usage limit,” and chats, tasks, or workflows stop working.
How credits work
TeamMate meters model usage in credits drawn from the workspace balance. Before each model call, a pre-flight check verifies two things:
- The workspace credit balance is above zero.
- The current user is under their monthly usage cap, if an admin set one.
If either check fails, the call is rejected before it runs. The two failures are distinct:
| Message | Reason | Who fixes it |
|---|---|---|
| Your workspace has run out of credits | Workspace balance is zero | Workspace admin purchases more credits |
| You have reached your monthly usage limit | The user hit their per-user cap | Admin raises that user’s cap |
Workspaces with billing disabled skip both checks entirely. If you never see credit errors, billing is likely off for your workspace.
Step-by-step fix
- Identify which limit you hit
Read the exact message. “Out of credits” is a workspace-wide balance problem; “monthly usage limit” is a per-user cap problem. They are fixed differently.
- Check the balance
Open Settings → Usage & Billing to see the current workspace credit balance and recent usage.
- Add credits (workspace balance)
If the balance is zero, a workspace admin purchases more credits from Usage & Billing. New balance applies immediately to the next call.
- Raise a user cap (monthly limit)
If a specific user hit their cap, an admin increases that user’s monthly usage cap. The user can continue once the cap is above their current usage.
- Retry the action
Resend the message or re-run the task or workflow once credits or the cap are corrected.
Where to look
- Usage & Billing — /settings/usage-billing for balance, usage, and per-user caps.
- Spending controls — review governance spending controls to set caps that prevent surprise depletion.