> ## Documentation Index
> Fetch the complete documentation index at: https://controlplanecorporation-kyle-cron-and-quotas.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quotas

> Understand Control Plane quotas — the per-resource limits applied to your org, how to view current usage against the allowed maximum, and how to request a higher limit through a quota increase request.

## Overview

A quota is a limit on how many of a given Control Plane resource your [org](/reference/org) may use. Each quota tracks two values:

* **Current** — how much of the resource the org is using right now.
* **Max** — the highest value the org is allowed to reach.

When the current usage of a resource reaches its max, further attempts to create that resource are rejected until usage drops or the max is raised.

Quotas are applied per org. Some are counted at the org level (for example, the number of domains), while others are counted within each [GVC](/reference/gvc) (for example, the number of workloads per GVC). See the [Quota reference](/reference/quota) for the full list of resources that have a quota.

## Quota Catalog

The **quota catalog** is the read-only list of every quota that can exist on an org. Each catalog entry describes a quota by name, along with the unit it is measured in and a short description. Use the catalog to discover which quotas you can view and request increases for, and the exact `quotaName` to use when submitting a request.

A catalog entry is not org-specific — it describes the quota in general. To see the current and max values for a quota on your own org, list your org's quotas instead.

## Increasing a Quota

When you need a higher limit, submit a **quota increase request** for a single quota and the new max you want. Control Plane then evaluates the request:

* Requests that fall within the range Control Plane can grant automatically are **approved immediately**, and the higher limit is applied to your org shortly afterward.
* Larger requests are placed in the **pending** state and reviewed by the Control Plane team before being approved or denied.

A quota increase request moves through one of the following statuses:

| Status     | Meaning                                                               |
| :--------- | :-------------------------------------------------------------------- |
| `pending`  | The request has been received and is awaiting review.                 |
| `approved` | The request was granted. The new max is applied to your org.          |
| `denied`   | The request was reviewed and not granted. The quota max is unchanged. |

Each request records the new max you asked for (`requestedMax`), who submitted it, when it was created, and—once it is no longer pending—when and by whom it was resolved. Approved requests, whether automatic or reviewed, raise the quota's max only when the current max is below the requested value; a request for a value at or below the current max is considered already satisfied.

You can track a request after submitting it by retrieving it by its ID, or by listing all of your org's requests (optionally filtered by status). See [Check the status of a request](/guides/manage-quotas#check-the-status-of-a-request) in the guide.

<Note>
  Requesting an increase never lowers a quota. To request a value below your current max, contact [support@controlplane.com](mailto:support@controlplane.com).
</Note>

## Permissions

Viewing quotas and submitting quota increase requests for an org require the org-level `view` permission. See [Quota permissions](/reference/quota#permissions) for the permissions used to define [policies](/reference/policy).

## Next Steps

* Follow the [Manage Quotas guide](/guides/manage-quotas) to view quotas, browse the catalog, and submit and track increase requests through the API.
* See the [Quota reference](/reference/quota) for the list of quota resources and their permissions.