> 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/ai-workbench-qore/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 **Cost Control → 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](/ai-workbench-qore/control-center/cost-control/credit-usage.md).

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

***

{% columns %}
{% column width="83.33333333333334%" %}

<p align="right"><em>Maintained by</em> <mark style="color:green;">Abhishek Paul</mark><br><code>AI-assisted, human-approved</code></p>
{% endcolumn %}

{% column width="16.666666666666664%" %}

<div align="left"><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-d034645b4f8f8ee661985f5306b60ded3289653c%2Fmaintainer-abhishek-paul.png?alt=media" alt="" width="60"></div>
{% endcolumn %}
{% endcolumns %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
