> For the complete documentation index, see [llms.txt](https://karini-ai.gitbook.io/karini-ai-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://karini-ai.gitbook.io/karini-ai-documentation/budgeting-and-cost-management/budget-limits-configuration.md).

# Budget Limits Configuration

The **Budget Limits Configuration** section allows authorized users to define and enforce spending limits across the organization. When budgeting limits are enabled, each AI request is evaluated against the applicable cap before processing. Requests that would cause an organization, Copilot, Recipe, or user to exceed its configured budget limit are blocked automatically.

{% hint style="info" %}
Only users with **Superuser** role can enable, disable, or modify budget limits.
{% endhint %}

#### Enabling Budgeting

Budgeting must be enabled before any configured budget caps can be enforced. Use the master control in **Organization Settings** to activate or deactivate budget enforcement across the organization.

To enable budgeting:

1. Navigate to **Organization Settings**.
2. Locate the **Budgeting Limits** section.
3. Select the **Enable budgeting limits** checkbox.

Once enabled, all configured budget limits become active and are evaluated for each applicable AI request.

Clearing the **Enable budgeting limits** checkbox disables budget enforcement across the organization. When disabled, AI requests are not blocked based on budget usage, even if individual budget caps remain configured.

Refer to the following video for configuring the budget.

{% embed url="<https://www.loom.com/share/9b6ba769605e4f5aa73a7863ce75d132>" %}

#### Budget Limit Scopes

After budgeting is enabled, limits can be configured independently at four scopes. Each scope determines how daily and monthly spending caps are applied and enforced across the organization.

**1. Organization-Level Limits**

Organization-level limits control the total combined spending of the entire organization. These limits provide an overall spending boundary and apply across all users, Copilots, Recipes, and AI activity within the organization.

* **Monthly limit:** Defines the maximum total amount the organization can spend during a calendar month.
* **Daily limit:** Defines the maximum total amount the organization can spend during a calendar day.
* **Limits enabled:** Determines whether organization-level limits are included in budget enforcement.

**Default limits:**

* **Monthly:** $300
* **Daily:** $20

**2. Copilot-Level Limits**

Copilot-level limits control spending for each Copilot individually. The values configured at this scope are applied as default limits to all Copilots unless a specific Copilot has an individual override.

* **Monthly limit:** Defines the default maximum monthly spend for each Copilot.
* **Daily limit:** Defines the default maximum daily spend for each Copilot.
* **Limits enabled:** Determines whether Copilot-level limits are included in budget enforcement.

**Default limits:**

* **Monthly:** $50
* **Daily:** $5

**3. Recipe-Level Limits**

Recipe-level limits control spending for each Recipe individually. The values configured at this scope are used as default limits for all Recipes unless an individual Recipe override is configured.

* **Monthly limit:** Defines the default maximum monthly spend for each Recipe.
* **Daily limit:** Defines the default maximum daily spend for each Recipe.
* **Limits enabled:** Determines whether Recipe-level limits are included in budget enforcement.

**Default limits:**

* **Monthly:** $50
* **Daily:** $5

**4. User-Level Limits**

User-level limits control spending for individual users based on their assigned roles. Separate default limits can be configured for each role, and these limits apply unless a specific user has an individual override.

The following user roles are supported:

* **Admin Users:** Users assigned the **Organization Admin** role.
* **Power Users:** Users assigned the **Power User** role.
* **Copilot Users:** Standard users assigned the **Copilot User** role.

For each role, configure the following fields:

* **Monthly limit:** Defines the default maximum monthly spend for each user assigned to the role.
* **Daily limit:** Defines the default maximum daily spend for each user assigned to the role.
* **Limits enabled:** Determines whether limits for the selected role are included in budget enforcement.

**Default limits:**

* **Admin Users:** $10 monthly and $2 daily.
* **Power Users:** $5 monthly and $1 daily.
* **Copilot Users:** $3 monthly and $0.50 daily.

#### **Validation Rules**

The following validation rules apply when configuring and saving budget limits:

* **Monthly and daily limits must be greater than 0:** A value of `0` is not valid. Leave the field empty to remove the corresponding budget cap.
* **Daily limit must be less than the monthly limit:** When both limits are configured, the daily limit must be lower than the monthly limit.
* **No override can exceed org-level caps :** Whether set for individual users,recipes, or copilots, all limits are bounded by the organization's monthly and daily caps.

#### Individual Entity Overrides

Individual budget limits can be configured for specific **Users**, **Copilots**, and **Recipes**. These limits override the applicable organization-level defaults for the selected entity.

**User Override**

To configure an individual budget limit for a user:

1. Navigate to **Organization Settings → Users**.
2. Select the required user.
3. Enable **Individual budget limiter**.
4. Enter the daily and/or monthly limit.
5. Select **Save**.

Refer to the following video configuring a user-level budget override.

{% embed url="<https://www.loom.com/share/64b3143fb37b46daa6df03c3cc226df4>" %}

**Copilot Override**

To configure an individual budget limit for a Copilot:

1. Navigate to **Copilots**.
2. Select the required Copilot.
3. Open the **Edit Copilot** page from the **Actions** menu.
4. Enable **Individual budget limiter**.
5. Enter the daily and/or monthly limit.
6. Select **Save**.

Refer to the following video for configuring a copilot-level budget override.

{% embed url="<https://www.loom.com/share/ada2f9ae6a7f40e8b785770a6d2018b3>" %}

**Recipe Override**

To configure an individual budget limit for a Recipe:

1. Navigate to **Recipes**.
2. Select the required Recipe.
3. Open the Recipe right panel..
4. Enable **Individual budget limiter**.
5. Enter the daily and/or monthly limit.
6. Select **Save**.

Refer to the following video for configuring a Recipe-level budget override.

{% embed url="<https://www.loom.com/share/fa0a2ce763ad4ae59289184cb8d1fb46>" %}
