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

# Set an Astro AI token spending cap

> Limit how much your Organization spends on Astro AI tokens each month, and learn what happens when the cap is reached.

An Astro AI token spending cap sets a monthly limit, in US dollars, on your Organization's Astro AI token spend. When your spend reaches the cap, Astro blocks new AI requests for the whole Organization until the cap resets.

## What counts toward the cap

The cap measures your total Astro AI token spend. This total is the sum of both billable line items:

* Model Chargeback
* Intelligence fee

Requests that use your own model provider (bring your own model) don't create Astro AI token spend, so they don't count toward the cap.

The cap resets at 00:00 UTC on the first day of each month.

## Prerequisites

* The Organization Owner or Organization Billing Admin role.
* AI features enabled for your Organization. See [Toggle AI features for your Organization](/docs/astro/enable-disable-astro-ai). If AI features are disabled, the setting shows **N/A**.

## Set the cap

1. In the Astro UI, click **Organization Settings**, then click **Billing**.
2. In the **Policies** section, find **Astro AI token spending cap**.
3. Enter a monthly limit in US dollars and save your changes.

The **Policies** section shows the status of the cap: **OK** while spend is under the cap, or **IN\_ALARM** after spend reaches it.

## What happens when the cap is reached

When the cap status changes to **IN\_ALARM**, Astro rejects new AI requests from every user in your Organization until the cap resets. This applies to every surface that uses Astro AI, including:

* Otto in the Astro UI and the Astro CLI.
* AI-powered authoring in the [Astro IDE](/docs/astro/ide-overview).
* [Otto code review](/docs/astro/otto/otto-code-review) and [investigations](/docs/astro/otto/otto-investigate).

Blocked requests fail with a usage limit error.

To restore access before the monthly reset, increase or remove the cap.

<Note>
  The cap is a soft limit. Requests that are already running when the cap is reached can finish, so your total spend can go slightly above the cap.
</Note>

<Note>
  Astro doesn't send a warning or email before the cap is reached. Check the cap status on the **Billing** page to monitor it.
</Note>