# Workspace Credit Allocation

Workspace Credit Allocation defines how credits are distributed across workspaces. It allows organizations to either use a shared credit pool or assign fixed budgets to individual workspaces, enabling controlled and transparent usage.

{% embed url="<https://youtu.be/r6NShDw7Nls?si=wEBv0NmPeYNlex0D>" %}

***

### Credit Modes

You can switch between modes from the dropdown at the top of the **Workspaces** tab.

#### 1. Shared Pool Mode

All workspaces consume credits from a single shared pool.

* Credits reside in the **Primary Workspace**
* No per-workspace limits are enforced
* All usage deducts from the same central balance

**When to use:**\
Suitable for smaller teams or when centralized control is sufficient.

#### 2. Workspace Budget Mode

Each workspace operates within an assigned credit limit.

* Credits are distributed to individual workspaces
* Usage is restricted to the allocated budget
* Additional credits must be assigned when required

**When to use:**\
Recommended for managing multiple teams, clients, or projects with defined budgets.

***

### Primary Workspace

The **Primary Workspace** acts as the default credit source.

* All purchased or added credits are stored here
* Its balance updates dynamically based on allocations

**Example:**\
If total credits = 10,000

* 2,000 allocated to Workspace A
* 3,000 allocated to Workspace B

Primary Workspace balance = **5,000**

***

### Allocating Credits

Credits can be transferred between workspaces in **Workspace Budget Mode**.

#### Steps

1. Go to **Dashboard → Workspaces tab**
2. Open the **⋯ (three-dot menu)** for a workspace
3. Select **Manage Credits**
4. Choose a source workspace
5. Enter the credit amount
6. Review updated balances
7. Click **Transfer**

***

### Credit Behavior

* Each workspace consumes credits from its own balance (in budget mode)
* The Primary Workspace reflects the remaining organizational balance
* If a workspace runs out of credits, usage is blocked until more credits are assigned

***

### Transfer Rules

* Credits can be moved between any workspaces with available balance
* Transfers cannot exceed available credits in the source workspace
* Changes apply immediately

***

### Deletion Impact

* Remaining credits in a deleted workspace return to the **Primary Workspace**
* The Primary Workspace cannot be deleted

***

### Why This Matters

* Enables controlled distribution of credits
* Prevents uncontrolled usage
* Provides visibility at the workspace level
* Ensures accountability across teams


---

# Agent Instructions: 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:

```
GET https://docs.qolaba.ai/organization-and-workspaces/workspaces/workspace-credit-allocation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
