> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/control-center/cost-control/usage-limits.md).

# Usage Limits

Set credit spending caps and receive threshold alerts.

Set hard caps for credit consumption and alerts for administrators. Open **Billing → Usage Limits**.

{% hint style="info" %}
**Credit limits exist at three levels**, and the strictest applicable one wins: an organization-wide cap, the per-account limits and alerts this page configures, and a per-agent credit guardrail set in Agent Builder. Every account also starts with a default weekly hard limit, until you replace it with your own.
{% endhint %}

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-aea6438f7b690c3f4e22588d1f2e0f5654614e61%2Fqore_control-center_control-centre-billing-credit-usage-limits_rounded_shadow.png?alt=media" alt="The Usage Limits screen, listing configured limits and alerts"><figcaption><p>Usage Limits, with configured limits and alerts.</p></figcaption></figure>

### Create usage limits

Usage limits are hard caps. Requests that would exceed a limit are rejected.

Each limit shows its period, cap, and type. For example, a **Monthly** limit of `80,000 Credits` can be a **Hard Limit**. It resets on the first day of each month.

Select **+ Add Limit** to create a limit. Use a row's menu to edit or remove it.

### Add an alert

Usage alerts email every **Account Admin** role holder on the account once per period after usage crosses a threshold — not every administrator on the platform. Select **+ Add Alerts** to create one.

**+ Add Alerts** opens the **Add Alert** dialog:

* **Duration**—required. The alert period, such as **Daily**
* **Metric Type**—required. **Absolute Credits** uses a credit count. **Percentage of Limit** uses a share of a configured limit
* **Credit Limit** or threshold—required. Enter a credit count for **Absolute Credits**. Enter a percentage for **Percentage of Limit**

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-ea3247b498346d607819d7c53adbcbcb8d68c0a8%2Fqore_control-center_control-centre-billing-credit-usage-limits-add-alert_rounded_shadow.png?alt=media" alt="The Add Alert dialog, with Duration, Metric Type, and Credit Limit fields"><figcaption><p>The Add Alert dialog.</p></figcaption></figure>

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-4b3cdfad20eeeea9718413cc1568646998fa3f9c%2Fqore_control-center_control-centre-billing-credit-usage-limits-add-alert-metric-type_rounded_shadow.png?alt=media" alt="The Metric Type dropdown in the Add Alert dialog, showing Absolute Credits and Percentage of Limit options"><figcaption><p>Choose **Absolute Credits** or **Percentage of Limit** as the alert metric.</p></figcaption></figure>

{% hint style="info" %}
**How it works:** The platform evaluates every usage limit before consumption. If a request exceeds any limit, the platform rejects it.
{% endhint %}

### Related

Review consumption and credit history in [Credit Usage](/control-center/cost-control/credit-usage.md).

{% content-ref url="/pages/807cab861e090edd0ce825909db3db1b28f73799" %}
[Control Center](/start-here/control-center.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.uptiq.ai/control-center/cost-control/usage-limits.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
