Credit Limits

​

Overview

Credit limits allow you to set spending limits on credit usage at both the Organization and Workspace levels. When a credit limit is reached, Kolena will automatically prevent further credit consumption to help you stay within budget.

​

How Credit Limits Work

Credit limits enforce spending limits by tracking cumulative credit usage and comparing it against configured thresholds:

• Organization-level limits: limit total overage credits across the entire Organization
• Workspace-level limits: limit total credits (monthly quota + overage) for specific Workspaces

When a limit is reached:

• New Prompts and Runs that would exceed the limit are prevented from starting
• Existing Runs continue to completion
• Administrators receive email notifications at 90% and 100% of the limit

​

Setting Up Credit Limits

​

Organization-Level Overage Limit

The Organization-level limit limits how many overage credits can be consumed beyond your monthly quota. To set an Organization-level overage limit:

1. Click “Manage Organization” from your user profile or navigate to your Organization page
2. Click the “Usage” button
3. Go to the Usage Limits section
4. Click the Configure Overage Limit button to set the Organization-level overage limit

For example, if your monthly quota is 10,000 credits and you set an overage limit of 5,000 credits:

• You can use up to 15,000 total credits per month (10,000 quota + 5,000 overage)
• After 15,000 credits, new Prompts and Runs will be blocked until the next month
• Prepaid credits are consumed but not counted toward the overage limit

​

Workspace-Level Limit

Workspace-level limits limit the total credits (monthly + overage) that can be consumed by a specific Workspace. To set a workspace-level limit:

1. Click “Manage Organization” from your user profile or navigate to your Organization page
2. Click the “Usage” button
3. Go to the Usage Limits section
4. Click the Configure Limits button to set the Workspace-level limit

For example, if you set a Workspace limit at 2,000 credits:

• The Workspace can consume up to 2,000 credits from monthly quota and overage combined
• After 2,000 credits, new Prompts and Runs in that Workspace will be blocked
• Other Workspaces remain unaffected

​

Notifications

Administrators receive email alerts when credit usage approaches or exceeds limits:

​

Organization-Level Alerts

• 90% threshold: Email sent when overage usage reaches 90% of the limit
• 100% threshold: Email sent when overage usage reaches or exceeds 100% of the limit

Organization administrators receive these notifications.

​

Workspace-Level Alerts

• 90% threshold: Email sent when Workspace usage reaches 90% of the limit
• 100% threshold: Email sent when Workspace usage reaches or exceeds 100% of the limit

Both Organization administrators and Workspace administrators receive these notifications.

​

Monitoring Credit Usage

To monitor your credit usage and limits:

1. Visit your Organization page
2. View the Usage section to see:
   • Current month’s credit consumption
   • Monthly quota and remaining credits
   • Overage credits used (if applicable)
   • Progress toward any configured limits

You can also view detailed credit usage by:

• Individual Agent
• Individual Run
• Workspace
• Time period

See Tracking Usage for more details on viewing and analyzing credit consumption.

​

Responding to Limit Alerts

When you receive a 90% threshold alert:

1. Review current usage patterns in your Organization page
2. Consider increasing the limit if usage is expected to continue
3. Investigate and optimize prompts or workflows if usage is higher than expected

When a limit is reached (100%):

1. Prompts and Runs cannot proceed until the limit is raised or the next billing period begins
2. Contact your Organization administrator to adjust limits if needed