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

# Credit Limits

> Control and manage spending with 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.

<Note>
  Credit limits are an optional feature available to Organizations on credit-based pricing plans.
  All limits are set on a monthly-basis.
  Usage resets back to zero at the start of each calendar month.
</Note>

## 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](https://agents.kolena.com/organization)
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

<img width="380" src="https://mintcdn.com/kolena/JJH0K8KIvjafHrmf/assets/credit_limits/organization_limit_modal.png?fit=max&auto=format&n=JJH0K8KIvjafHrmf&q=85&s=ba99deb068efc12693e8b77fca9b9226" data-path="assets/credit_limits/organization_limit_modal.png" />

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](https://agents.kolena.com/organization)
2. Click the "Usage" button
3. Go to the **Usage Limits** section
4. Click the **Configure Limits** button to set the Workspace-level limit

<img width="380" src="https://mintcdn.com/kolena/JJH0K8KIvjafHrmf/assets/credit_limits/workspace_limit_modal.png?fit=max&auto=format&n=JJH0K8KIvjafHrmf&q=85&s=f4e5c85aefa30b587a85256fd7380f19" data-path="assets/credit_limits/workspace_limit_modal.png" />

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

<Tip>
  Workspace-level limits are useful for:

  * Allocating budgets across different teams or projects
  * Limiting usage for experimental or test Workspaces
  * Providing guardrails for new users or pilot projects
</Tip>

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

<Note>
  Notifications are sent once per threshold per month. If usage fluctuates below and back above a threshold, a new notification will not be sent until the next month.
</Note>

## Monitoring Credit Usage

To monitor your credit usage and limits:

1. Visit [your Organization page](https://agents.kolena.com/organization?tab=data-and-security)
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

<img width="380" src="https://mintcdn.com/kolena/JJH0K8KIvjafHrmf/assets/credit_limits/limit_info.png?fit=max&auto=format&n=JJH0K8KIvjafHrmf&q=85&s=08b55e66af49b2ceaad41d3882af1fee" data-path="assets/credit_limits/limit_info.png" />

You can also view detailed credit usage by:

* Individual Agent
* Individual Run
* Workspace
* Time period

See [Tracking Usage](/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](https://agents.kolena.com/organization?tab=data-and-security)
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