> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/org/credits/member-credit-quota.md).

# Member Credits Quota Management

Organization administrators can set a **personal Credits spending cap (Quota)** and **validity period** for each member, making costs during events or specific projects transparent and controllable.

{% hint style="info" %}
**Only available for organizations using the Credits billing system.** If your organization has not yet switched to the Credits system, this feature will not be displayed. See [Credits Billing System](/maiagent-user-guide/maiagent-user-guide-en/org/credits.md) for details.
{% endhint %}

## Core Concept <a href="#core-concept" id="core-concept"></a>

**A Quota is a spending ceiling, not a pre-funded sub-wallet.**

The organization's Credits wallet remains the sole funding pool. A Quota only limits how many Credits a specific member can consume from the organization wallet. Distributing a Quota does not affect the organization balance, and Quota expiration does not affect the balance either — there is no concept of "returning" Credits.

## Use Cases <a href="#use-cases" id="use-cases"></a>

* An enterprise hosts an event and grants external users platform access, needing to control per-person spending caps
* Different departments set different personal quotas based on their budgets
* Limit a specific account's usage during a validity period, with automatic enforcement after expiration

***

## Administrator Operations <a href="#admin-operations" id="admin-operations"></a>

### Accessing the Quota Allocation Page <a href="#enter-quota-tab" id="enter-quota-tab"></a>

1. Click <mark style="color:blue;">**Organization Settings**</mark> from the left menu
2. Click <mark style="color:blue;">**Credits**</mark>
3. Switch to the <mark style="color:blue;">**Quota Allocation**</mark> tab

The page displays the quota status for all members, including summary cards (All Members, Allocated Quotas, Expired, Unassigned) and progress bars.

### Distribute Quota <a href="#assign-quota" id="assign-quota"></a>

1. Click the <mark style="color:blue;">**Distribute Quota**</mark> button in the upper right corner
2. Search for the target member by name or email in the search box
3. Enter the **Credits cap** (spending ceiling)
4. Set the **validity period** (you can set an expiration date or choose permanent)
5. Click <mark style="color:blue;">**Confirm**</mark> to complete the distribution

{% hint style="info" %}
Each member can only have one active quota at a time. For members who already have an active quota, use "Edit" to adjust it directly, or disable the current quota before distributing a new one.
{% endhint %}

### Edit Quota <a href="#edit-quota" id="edit-quota"></a>

For members with an active quota, click <mark style="color:blue;">**Edit**</mark> on their row to adjust:

* **Increase the Credits cap**: Takes effect immediately
* **Decrease the Credits cap**: Cannot be set lower than the member's current consumption; the system will display an error message

### Disable Quota <a href="#disable-quota" id="disable-quota"></a>

For active members, click <mark style="color:blue;">**Disable**</mark> → confirmation dialog → after confirming, the member's quota is immediately invalidated.

The effect of disabling depends on the "Quota Required" toggle:

* **Toggle is ON**: The member will be unable to use AI features and needs a new quota distributed or the toggle turned off
* **Toggle is OFF**: The member returns to unrestricted status, with consumption directly drawn from the organization wallet

### "Quota Required" Toggle <a href="#quota-required-toggle" id="quota-required-toggle"></a>

Each member row has a **Quota Required** toggle on the right side:

| Toggle State | Description                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **ON**       | The member must have an active quota to use AI; without a quota (expired / disabled / unassigned), access is fully blocked |
| **OFF**      | The member is not restricted by quota; consumption is drawn directly from the organization wallet                          |

{% hint style="warning" %}
**When distributing a quota**, the system **automatically turns ON** "Quota Required."

**When turning OFF the toggle**, if the member has an active quota, the system will **simultaneously disable** that quota to avoid conflicting states. A confirmation dialog explaining the impact will be displayed before each switch — please review before proceeding.
{% endhint %}

***

## Members Checking Their Own Quota <a href="#member-self-check" id="member-self-check"></a>

Members can view their personal Credits usage from their Profile:

1. Click the account avatar in the upper right corner
2. Click <mark style="color:blue;">**Personal Settings**</mark>
3. Switch to the <mark style="color:blue;">**Credit Quota**</mark> tab

{% hint style="info" %}
Members of **non-Credits billing organizations** will not see the "Credit Quota" tab in their Profile.
{% endhint %}

The page displays different content based on the member's quota status:

| Status                                                     | Display Content                                                                                                                                                           |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Has active quota**                                       | Progress bar (used / total cap), remaining Credits, expiration countdown                                                                                                  |
| **Quota required but none available (expired / disabled)** | Red alert: "You need a quota to use AI services. Currently no quota is assigned, or your quota has expired. Please contact your administrator to distribute a new quota." |
| **Quota not required**                                     | Gray notice: "You currently have no personal quota limit. Consumption is drawn directly from the organization wallet — no need to worry about personal quota caps."       |

The progress bar color changes based on usage ratio (green for low usage, approaching red for high usage) to remind members to monitor their remaining balance.

***

## Notes <a href="#notes" id="notes"></a>

### Applicable Scope <a href="#applicable-scope" id="applicable-scope"></a>

Personal quota enforcement **only applies to the following entry points**:

* Operations through the MaiAgent admin dashboard
* API Key calls to the `/completions/` endpoint
* Knowledge Base uploads and document processing

{% hint style="info" %}
**WebChat channels are not subject to personal quota limits.** Messages sent through the embedded WebChat widget on websites consume the organization wallet directly, regardless of whether the visitor is logged in.
{% endhint %}

### Fail-Open Mechanism <a href="#fail-open" id="fail-open"></a>

{% hint style="info" %}
To prevent service interruptions caused by quota boundary calculation issues, the system uses a **Fail-Open** strategy:

When the remaining quota is > 0 at the time of checking, the current request is allowed through; consumption is recorded only after the AI completes its response. If the consumption exceeds the cap, the **next** request will be blocked. This ensures users never experience a billing failure at the same time as receiving an AI response.
{% endhint %}


---

# 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.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/org/credits/member-credit-quota.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.