Skip to main content

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.

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

1

Open organization settings

Click your account name at the bottom of the sidebar, then click the gear icon next to your organization name.
2

Navigate to Usage Limits

In the left sidebar, click Limits & Alerts under the Usage section.
3

Open the Organization Alerts section

Expand Organization Alerts at the top of the page, then click Add alert.
Organization Credit Alerts on the Limits & Alerts page
4

Choose a threshold type

Select how the threshold should be measured:
TypeDescriptionExample
PercentageA percentage of your organization’s credit maximum for the billing periodAlert at 75% of 10,000 credits = fires at 7,500 credits used
AbsoluteA fixed number of creditsAlert 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.
Adding an Organization Credit Alert
5

Set the threshold value

Enter the percentage (1–100) or credit count that should trigger the alert.
6

Choose who to notify

Select either All Admins or Specific Admins. If you choose specific admins, use the selector to pick who should receive the alert email.
Selecting admins to notify when the alert triggers
7

Save

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.
1

Open organization settings

Click your account name at the bottom of the sidebar, then click the gear icon next to your organization name.
2

Navigate to Usage Limits and enable alerts

In the left sidebar, click Limits & Alerts under the Usage section. Toggle on Credit Usage Alerts.
Limits & Alerts page in Organization Settings showing Credit Usage Alerts enabled
3

Configure the credit alert threshold

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.
Credit Alert Threshold field specifying number of credits that triggers an alert
4

Enable user notifications (optional)

Toggle on Notify the user who triggered the alert if you want the user to receive an email notification when they exceed the threshold.
Notify the user who triggered the alert toggle
5

Select admins to notify

Choose which admins should receive email notifications when a user exceeds the threshold.
Admins to Notify selector for credit usage alerts
6

Save

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.
1

Enable per-user credit limits

On the Limits & Alerts page, toggle on Per-User Credit Limits.
Per-User Credit Limits toggle enabled on the Limits & Alerts page
2

Set the default limit

Under Default Limit Per User, specify the credit limit that applies to all users (e.g., 1000 credits per billing period).
Default Limit Per User field showing the credit limit per billing period
3

Select admins to notify

Choose which admins should receive email notifications when any user hits their credit limit.
Admins to Notify selector for per-user credit limits
4

Configure exclusions (optional)

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 won’t count toward user limits.
  • Exclude Workflows from Credit Limits — Credits used by Workflows won’t count toward user limits.
Exclusion toggles for Agent deployments and Workflows
Excluding Workflow and deployment credits is useful when those are shared team resources, not individual consumption.
5

Add custom limits for specific users (optional)

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.
Add Custom Limit button for overriding per-user credit limits
Custom limit configuration showing user selection and credit limit value
6

Monitor users exceeding their budget

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.
Users Exceeding Credit Budget section showing users who hit their limit
7

Save

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 alertsPer-user alertsPer-user limits
What triggers itTotal organization usage crosses a thresholdAn individual user crosses a thresholdAn individual user hits their cap
Threshold typesPercentage or absoluteAbsolute creditsAbsolute credits
Restricts usage?NoNoYes — 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

Manage credits

Understand how credits work and check your balance.

Monitor usage

Track credit, storage, and meeting usage across your organization.