---
title: AI Credit Limits
description: >-
  Set monthly AI Credit limits at the organization level, the per-user level, or
  both, and override limits for individual users.
breadcrumbs: Docs > Account Management > Billing > AI Credit Limits
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# AI Credit Limits

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Organization admins can set monthly caps on AI Credit usage at the organization level, the per-user level, or both. Admins can also override the default per-user limit for individual users. AI Credits are shared across [Bits Chat](https://docs.datadoghq.com/bits_ai/bits_chat.md), [Bits Investigation](https://docs.datadoghq.com/bits_ai/bits_investigation.md), [Bits Code](https://docs.datadoghq.com/bits_ai/bits_code.md), and [Bits Agent Builder](https://docs.datadoghq.com/actions/agents.md).

## Permissions{% #permissions %}

To view and set AI Credit limits, a user needs the [`billing_edit` permission](https://docs.datadoghq.com/account_management/rbac/permissions.md#billing-and-usage).

## Where to set limits{% #where-to-set-limits %}

AI Credit limits are configured in [**Bits AI > AI Credits Management**](https://app.datadoghq.com/bits-ai/ai-credits-management).

## Types of limits{% #types-of-limits %}

You can configure three types of monthly limits:

| Limit type              | Description                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| Organization-wide limit | Caps total AI Credit usage across the organization for the month. No organization-wide limit is set by default. |
| Default per-user limit  | Caps monthly AI Credit usage for each user who doesn't have an individual override.                             |
| Per-user override       | Sets a custom monthly limit for an individual user, replacing the default per-user limit for that user.         |

## How limits are applied{% #how-limits-are-applied %}

- When both an organization limit and a user limit (or override) are configured, the most restrictive applicable limit applies to a user.
- If a user has both a default per-user limit and an override configured, the higher of the two applies, and the user's usage is still subject to the organization-wide limit.
- Raising a limit unblocks users who reached the previous limit. Lowering a limit blocks users whose usage already exceeds the new value.
- When a user or the organization reaches a limit, affected users can't use Bits Chat, Bits Investigation, Bits Code, or Bits Agent Builder, and a banner shows the reset date.
- When a limit is reached, requests to start an investigation through the [Bits AI API](https://docs.datadoghq.com/api/latest/bits-ai.md) return HTTP `429` with the error code `AI_CREDITS_EXHAUSTED`. A `429` with the error code `INVESTIGATION_RATE_LIMIT_EXCEEDED` means an [investigation rate limit](https://docs.datadoghq.com/bits_ai/bits_investigation/configure.md#configure-rate-limits) was reached instead.

### Examples{% #examples %}

| Organization limit | Per-user limit          | Users | Maximum hypothetical usage    | Maximum billable AI Credits | Result                                                                                                   |
| ------------------ | ----------------------- | ----- | ----------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------- |
| 2,000 AI Credits   | 50 AI Credits per user  | 20    | 50 × 20 = 1,000 AI Credits    | 1,000 AI Credits            | Each user can use up to 50 AI Credits without other restrictions.                                        |
| 2,000 AI Credits   | 200 AI Credits per user | 20    | 200 × 20 = 4,000 AI Credits\* | 2,000 AI Credits            | Each user can use up to 200 AI Credits until the organization-wide limit of 2,000 AI Credits is reached. |
| Not set            | 200 AI Credits per user | 20    | 200 × 20 = 4,000 AI Credits   | 4,000 AI Credits            | Each user can use up to 200 AI Credits without other restrictions.                                       |

\* A configured organization limit acts as the ceiling for the organization, regardless of the sum of hypothetical per-user limits.

## Usage attribution{% #usage-attribution %}

Attribution determines whose limit applies to a given unit of AI usage, and who the AI Credit spend is attributed to.

| Product                                                                        | Attribution                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Bits Chat](https://docs.datadoghq.com/bits_ai/bits_chat.md)                   | All Bits Chat usage, including chats inside an investigation, rolls up to the email address of the user interacting with Bits Chat.                                                                                                                                                                                                                         |
| [Bits Investigation](https://docs.datadoghq.com/bits_ai/bits_investigation.md) | Manually started investigations roll up to the email address of the user who initiated the action.Investigations started through the API roll up to the user or service account that owns the API key, and count toward that account's limits.Automatically triggered investigations (for example, from a monitor firing) roll up to **Autonomous Agents**. |
| [Bits Code](https://docs.datadoghq.com/bits_ai/bits_code.md)                   | All Bits Code usage rolls up to the email address of the user interacting with Bits Code.                                                                                                                                                                                                                                                                   |
| [Bits Agent Builder](https://docs.datadoghq.com/actions/agents.md)             | Agent runs for workflows roll up to the email address of the user who created the workflow.Agent runs for workflows created by service accounts roll up to **Autonomous Agents**.                                                                                                                                                                           |

## Get alerted before reaching a limit{% #get-alerted-before-reaching-a-limit %}

To get notified before users reach their limit, use the AI Credits [usage metrics](https://docs.datadoghq.com/account_management/billing/ai_credits.md#monitor-usage), grouped by `user_handle`, in a [metric monitor](https://docs.datadoghq.com/monitors/types/metric.md).

## Further reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [AI Credits](https://docs.datadoghq.com/account_management/billing/ai_credits.md)
