> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Credit usage alerts and limits
> Monitor organization-wide credit consumption and set per-user spending caps to keep your team's AI usage in check.
Cassidy gives you two layers of credit visibility: **organization alerts** that track your team's total usage against the allowance for your billing period, and **per-user alerts and limits** that monitor and cap individual consumption. Both are configured in **Organization Settings → Limits & Alerts**.
Only **Admins** can configure credit alerts and limits.
***
## Organization alerts
Organization alerts notify admins when your organization's **total** credit usage crosses a threshold you define. They are **informational only** — they don't restrict usage.
### Add an alert
Click your account name at the bottom of the sidebar, then click the **gear icon** next to your organization name.
In the left sidebar, click **Limits & Alerts** under the **Usage** section.
Expand **Organization Alerts** at the top of the page, then click **Add alert**.
Select how the threshold should be measured:
| Type | Description | Example |
| -------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Percentage** | A percentage of your organization's credit maximum for the billing period | Alert at 75% of 10,000 credits = fires at 7,500 credits used |
| **Absolute** | A fixed number of credits | Alert at 8,000 credits, regardless of the maximum for the billing period |
Percentage thresholds automatically scale if your credit allowance changes. Absolute thresholds give you a precise spending target.
Enter the percentage (1–100) or credit count that should trigger the alert.
Select either **All Admins** or **Specific Admins**. If you choose specific admins, use the selector to pick who should receive the alert email.
Click **Add** to activate the alert.
The alert will fire the first time your organization's credit usage crosses the threshold within each billing period.
### How organization alerts work
* Each alert fires **once per billing period**. Usage dropping below the threshold and climbing back above it will not re-trigger the alert until the next billing period resets.
* You can configure **multiple alerts** at different thresholds — for example, one at 50% and another at 90% — to get early warnings and final notices.
* To change a threshold or notification recipients, click the **pencil icon** next to an alert. To remove an alert, click the **trash icon**.
Editing an alert's threshold resets it so it can fire again in the current
billing period. If your organization is already past the new threshold, the
alert will trigger immediately.
***
## Per-user alerts and limits
Per-user controls let you notify admins when individual team members exceed a credit threshold, and optionally enforce a **hard cap** that blocks users from consuming additional credits once their limit is reached.
### Set up per-user credit usage alerts
Credit usage alerts notify admins when a team member exceeds a specified credit threshold during a billing period. Alerts are **informational only** — they don't block users from consuming additional credits.
Click your account name at the bottom of the sidebar, then click the **gear icon** next to your organization name.
In the left sidebar, click **Limits & Alerts** under the **Usage** section. Toggle on **Credit Usage Alerts**.
Specify the number of credits that triggers an alert (e.g., 500 credits per billing period). Admins receive an email alert whenever any user exceeds this threshold.
Toggle on **Notify the user who triggered the alert** if you want the user to receive an email notification when they exceed the threshold.
Choose which admins should receive email notifications when a user exceeds the threshold.
Click **Save** to apply your credit alert configuration.
Your credit usage alert is now active. Admins will receive an email alert whenever any user exceeds the defined credit threshold in a billing period.
### Set up per-user credit limits
Per-user credit limits set a **hard cap** on how many credits each team member can consume per billing period. When a user hits their limit, they are blocked from credit-consuming actions and shown an explanation.
On the **Limits & Alerts** page, toggle on **Per-User Credit Limits**.
Under **Default Limit Per User**, specify the credit limit that applies to all users (e.g., 1000 credits per billing period).
Choose which admins should receive email notifications when any user hits their credit limit.
Toggle on the following options if you want to exclude certain usage from counting toward credit limits:
* **Exclude Agent External Deployments from Credit Limits** — Credits used by externally deployed [Agents](/agents/overview) won't count toward user limits.
* **Exclude Workflows from Credit Limits** — Credits used by [Workflows](/workflows/overview) won't count toward user limits.
Excluding Workflow and deployment credits is useful when those are shared team resources, not individual consumption.
Click **Add Custom Limit** to override the default limit for individual users. Select the user and set a specific credit cap, or leave them unlimited.
Review the **Users Exceeding Credit Budget** section to see which users have exceeded their credit limit in the current billing period, along with their current usage and limit.
Click **Save** to apply your credit limit configuration.
Per-user credit limits are now active. Limits reset at the start of each billing period. Custom limits take precedence over the default limit.
***
## Comparison
| | Organization alerts | Per-user alerts | Per-user limits |
| -------------------- | -------------------------------------------- | -------------------------------------- | --------------------------------- |
| **What triggers it** | Total organization usage crosses a threshold | An individual user crosses a threshold | An individual user hits their cap |
| **Threshold types** | Percentage or absolute | Absolute credits | Absolute credits |
| **Restricts usage?** | No | No | Yes — blocks AI features |
All three can be used together. For example, set an organization alert at 80% to track overall spend, per-user alerts to catch high individual usage early, and per-user limits to enforce a hard ceiling.
## Next steps
Understand how credits work and check your balance.
Track credit, storage, and meeting usage across your organization.