> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Track message credit usage across your workspace

> Track message credits and AI agent counts across your workspace, filtered by AI agent and time period

The Chatbase **Usage** page shows how many message credits your workspace has used, which AI agents used them, and how many AI agents you have against your plan's limit. It defaults to the current calendar month across all AI agents, and you can narrow it to a single AI agent or a different time period. Use it to see when you'll run out of credits and which AI agent is driving the cost.

> [card] What you can do:
>
> See where your message credits are going, which AI agent is consuming them, and how consumption is trending day by day.

![The Usage tab showing credits and AI agents for the current month](https://mintcdn.com/chatbase/xPpOvQF2MdeELnmI/user-guides/workspace/images/usage/usage-overview.png?fit=max\&auto=format\&n=xPpOvQF2MdeELnmI\&q=85\&s=2913666722e4bee8dec60942036a3d3f)

## Configuration

### AI agents

You can view usage for all your AI agents, a specific AI agent, or deleted AI agents, which lets you check the credits used by AI agents you've since removed. Use the **All agents** dropdown at the top of the page to switch between them.

![Switching between AI agents in the Usage tab](https://mintcdn.com/chatbase/PP3ngCxUjeoMGtCc/user-guides/workspace/images/usage/usage-chatbot-configuration.gif?s=fbd9acb710c0ae16a74ac1555446bddc)

### Time interval

You can configure the time interval to view usage for a specific period, such as last week. The selected interval is highlighted in blue.

![Adjusting the time interval in the Usage tab](https://mintcdn.com/chatbase/PP3ngCxUjeoMGtCc/user-guides/workspace/images/usage/usage-date-configuration.gif?s=0cad8ad1b9e37450868bcb9b68cd2f57)

## Usage summary

This section summarizes the credits used and the number of AI agents used within the time interval you specified.

### Credits used

The cards at the top show credits split by where they came from, not by feature or channel:

* **Default view** (the 1st of the month to today, all AI agents): **Plan credits used** and, if the workspace has any, **Auto-recharge credits used**.
* **Any other date range or a single AI agent:** one card, **Total credits used during the selected period**.

![The credits used summary](https://mintcdn.com/chatbase/ZcQpyIvpdwiRhf0d/user-guides/workspace/images/usage/usage-credits-used.png?fit=max\&auto=format\&n=ZcQpyIvpdwiRhf0d\&q=85\&s=ccac3d1ec125e271717795fecb1b7169)

### AI agents used

The number of AI agents in your workspace compared to the total allowed. For example, a workspace might have 4 AI agents out of 60.

* **Deleted AI agents aren't counted.** The count is the AI agents that exist now, so deleting one frees its slot right away.
* **The maximum is a real limit.** It's your plan's AI agent limit plus any Extra AI agents add-on. It's checked when you create, duplicate, or remix an AI agent.

![The AI agents used summary, showing current against maximum](https://mintcdn.com/chatbase/PP3ngCxUjeoMGtCc/user-guides/workspace/images/usage/usage-chatbots-used.png?fit=max\&auto=format\&n=PP3ngCxUjeoMGtCc\&q=85\&s=68021fa1ac67e56f6f4bef26947d68dd)

### Usage history

The number of message credits used per day for the selected time interval. Hover over a bar to see the exact credits used on that day.

![Daily message credit usage across the selected period](https://mintcdn.com/chatbase/PP3ngCxUjeoMGtCc/user-guides/workspace/images/usage/usage-history.png?fit=max\&auto=format\&n=PP3ngCxUjeoMGtCc\&q=85\&s=defd03aa17572365a60e9b6e15167bdb)

### Credits used per AI agent

Compares credit usage across AI agents for the selected time interval. Hover over any segment of the pie chart to see the exact number of credits used by that AI agent. Credits used by AI agents you've since deleted are grouped under **Deleted agents**.

![Credit usage split across AI agents as a pie chart](https://mintcdn.com/chatbase/PP3ngCxUjeoMGtCc/user-guides/workspace/images/usage/usage-credits-piechart.png?fit=max\&auto=format\&n=PP3ngCxUjeoMGtCc\&q=85\&s=58c6d9d3eb0b8838f5d9d9632ba50673)

## What uses message credits

Only these use message credits:

| Feature | Credit cost |
| - | - |
| AI agent replies on any channel, including the API | The AI model's credits per reply (see [Models comparison](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md)). A reply that triggers an Action costs twice the model's usual credits ([Credit usage](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#credit-usage)) |
| Image or file attachments in a conversation | Extra credits on top of the reply |
| Helpdesk AI draft replies | Credits at your AI agent's model rate |
| @Chatbase in Slack | Credits at your AI agent's model rate |
| [Voice](https://chatbase.co/docs/user-guides/chatbot/voice.md) calls | 6 credits a minute, with a full minute billed at the start |
| [Tests](https://chatbase.co/docs/user-guides/chatbot/tests.md) | Free until the monthly test-credit pool is used up, then message credits |

These don't use message credits: translation, AI Compose, takeover and close summaries, Linear drafts, spam checks, topic and sentiment analysis, knowledge gaps, and campaign sends. [Backstage](https://chatbase.co/docs/user-guides/chatbot/backstage.md) has its own daily message limit instead of using credits.

## When credits reset

Plan credits reset at **00:00 UTC on the 1st of every calendar month**, for every workspace, whatever your billing date. The Usage page says: "Your plan credits reset at the start of every calendar month."

* **Unused plan credits don't roll over.** The used count goes back to zero on the 1st.
* **Annual plans reset monthly too.** Plan credits are a monthly amount, so a yearly subscription gets its credits month by month, resetting on the 1st.
* **Auto-recharge credits don't expire.** They aren't reset on the 1st and carry over until used.
* **Plan credits are used first.** Auto-recharge credits are only used once you've used all of the month's plan credits.

Example: a workspace subscribed on March 15 still gets fresh plan credits on April 1 at 00:00 UTC, not on April 15.

## Getting more credits

* **Auto recharge** buys credits automatically when your balance drops below a threshold you set. See [Auto recharge credits](https://chatbase.co/docs/user-guides/workspace/settings.md#auto-recharge-credits).
* **Upgrade your plan** for a higher monthly allowance. See [Plans](https://chatbase.co/docs/user-guides/workspace/settings.md#plans).
* **Enterprise workspaces** contact their success manager to buy more credits.

There's no one-time credit purchase.

## Workspaces billed per conversation

Workspaces with the Enterprise **Conversations** add-on are billed per conversation instead of per credit. On these workspaces, the Usage page shows conversation counts instead of credits.

* **What counts:** every conversation created in the period, except Playground, Action preview, and Q\&A preview conversations.
* **When a conversation ends:** after it has been idle for a set time. A message after that point is likely to start a new conversation, which is counted separately.

## Usage alert

Get an email when your workspace has used a set share of its message credits, so you can upgrade or buy more before your AI agents stop responding.

To set it up:

1. Turn on the **Usage alert** toggle.
2. Enter a percentage under **Send an email when message credits used reach**. The number of credits that percentage equals is shown next to it, for example `(25 / 50 credits)`.
3. Under **Recipients**, add the email addresses that should get the alert.
4. Click **Save**.

The email says how many credits the workspace has used this month, when they reset, and links to the Usage page. Below the settings, **Last sent** shows the date the most recent alert went out.

> [!NOTE]
>
> When your message credits run out, your AI agents stop responding until the credits reset.

### When the alert is sent

The alert is sent once per calendar month, when usage first reaches your threshold. It resets on the 1st of each month at 00:00 UTC, the same time as your plan credits, whatever your billing date.

If your credit limit goes up during the month (for example, after you add credits), the alert can be sent once more when usage reaches the new threshold.

### When usage alerts aren't available

* **Auto recharge is on.** [Auto recharge](https://chatbase.co/docs/user-guides/workspace/settings.md#auto-recharge-credits) tops up your credits automatically, so you won't run out and no alert is needed. The **Usage alert** card is hidden while auto recharge is on.
* **Your workspace is billed per conversation.** Usage alerts apply only to credit-based billing.

> [!NOTE]
>
> Turning auto recharge off doesn't remove extra credits you already have. Those credits still appear on the Usage page and still count toward your alert threshold.

## Frequently asked questions

> [accordion] When do my Chatbase message credits reset?
>
> At 00:00 UTC on the 1st of every calendar month, for every workspace. Your billing date and whether you pay monthly or yearly don't change this.

> [accordion] Do unused message credits roll over?
>
> Plan credits don't roll over: the used count resets on the 1st. Auto-recharge credits don't expire and carry over until used.

> [accordion] Do translation, summaries, or topic and sentiment analysis use credits?
>
> No. Credits are only used for AI agent replies (plus attachments), Helpdesk AI draft replies, @Chatbase in Slack, voice calls, and Tests after the monthly test pool runs out. Backstage has its own daily message limit.

> [accordion] Why does the Usage page show only total credits used?
>
> The **Plan credits used** and **Auto-recharge credits used** cards only appear in the default view (this month, all AI agents). Pick another date range or a single AI agent and you see one **Total credits used during the selected period** card.

> [accordion] Do deleted AI agents count toward my AI agent limit?
>
> No. Only AI agents that exist now count, so deleting one frees a slot immediately. Their past credit use still shows under **Deleted agents**.

## Next steps

> [card] [Models Comparison](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md)
>
> Credit cost varies by model. See what each tier costs per message.

> [card] [Workspace settings](https://chatbase.co/docs/user-guides/workspace/settings.md)
>
> Manage your plan and set up auto recharge.

> [card] [Analytics](https://chatbase.co/docs/user-guides/chatbot/analytics.md)
>
> See conversation volume behind the credits you're spending.

> [card] [Manage](https://chatbase.co/docs/user-guides/workspace/manage.md)
>
> Create workspaces and control who can change what.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.