Credit Usage
Credits are the resource unit in AIChatVault. Each AI response consumed in a conversation uses credits from your organisation's shared pool. The Usage page at workspace level gives you a full breakdown of consumption.
Viewing credit usage
Go to the Usage page
Filter by agent (optional)
Select a date range
Read the dashboards
Credits used gauge
The circular progress gauge on the Usage page shows:
- •Credits used — the number in the centre of the gauge.
- •Your plan limit — shown below the number (e.g. 500 / 5,000). Plans with unlimited credits show ∞.
- •Credits remaining — shown in text below the gauge.
- •Reset date — when your credit allowance refreshes for the next billing period.
Agents used gauge
A second circular gauge shows how many agents you have created vs your plan's agent limit. This helps you see if you are approaching the maximum number of agents allowed on your current plan.
Usage history chart
The bar chart shows daily credit consumption over the selected date range. Hover over any bar to see the exact number of credits consumed on that day. Days with no usage show a minimal bar.
Credits per agent breakdown
The pie chart at the bottom of the Usage page shows how much each agent has consumed from the shared credit pool. This helps identify which agents are driving the most usage — useful for cost allocation or optimisation.
How credits work
| Fact | Detail |
|---|---|
| Scope | Credits are shared across all agents in your organisation — there is one pool per workspace |
| Consumption | Each AI-generated response consumes credits. The exact amount depends on the AI model used and the length of the response |
| Reset | Credits reset at the start of each billing period (monthly or annually depending on your plan) |
| Rollover | Unused credits do not carry over to the next period unless specified in your Enterprise plan agreement |
| Top-ups | You can purchase additional credits as a one-time add-on from Settings → Billing. Top-up credits do not expire |
When credits run out
When your organisation's credit balance reaches zero, agents stop generating AI responses. Visitors see a message indicating the agent is unavailable. To restore service:
- •Purchase a credit top-up add-on from Settings → Billing (credits are available immediately).
- •Upgrade your plan to a higher tier with a larger monthly credit allowance.
- •Wait for the next billing cycle reset.
Tracking usage in the UsageLog
Every credit-consuming event is recorded internally with the following data: organisation, agent, user (if logged in), event type, AI model used, token counts (tokens_in, tokens_out, total_tokens), monetary cost, and credits consumed. This data powers all the charts and breakdowns on the Usage page.
Was this page helpful?