# Create quota increase request

`POST /v1/organizations/{organization}/quotaIncreaseRequests`, operation `quotaIncreaseRequests.CreateQuotaIncreaseRequest`

Asks kosem to raise one of an organization's limits, on Team or Enterprise. kosem's team is emailed, and approves it, setting the limit, or declines it. One request of each quota is pending at a time. On Hobby or Pro, upgrading raises a limit instead, and a request fails with failed_precondition and the reason PLAN_REQUIRED.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `organization` | path | Yes | `string` | The organization's ID. |

## Request body

Content-Type: `application/json` (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `desiredLimit` | `integer (int64)` | Yes | The limit to ask for, more than the one now. |
| `justification` | `string` | Yes | What the organization needs it for, such as the work it runs, which kosem's team reads to decide. |
| `quotaId` | `string` | Yes | The quota whose limit to raise, such as resourcemanager.projects: one whose quota info's adjustment is REQUEST. |

## Responses

### 201

Created

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `answer` | `string` | No | What kosem wrote back, if anything; always with a decline. |
| `createTime` | `string (date-time)` | Yes | When it was asked. |
| `decideTime` | `string (date-time)` | No | When kosem approved or declined it; absent while pending. |
| `desiredLimit` | `integer (int64)` | Yes | The limit it asked for. |
| `displayName` | `string` | Yes | The quota's name, such as Concurrent vCPUs. |
| `grantedLimit` | `integer (int64)` | No | The limit kosem set, once approved. |
| `justification` | `string` | Yes | What the organization needs it for, as it wrote. |
| `limit` | `integer (int64)` | Yes | The organization's limit when it asked. |
| `name` | `string` | Yes | Resource name, organizations/{organization_id}/quotaIncreaseRequests/{quota_increase_request_id}. |
| `plan` | `string` | Yes | The plan it was asked on. An approved limit applies while the organization stays on it. Values: `TEAM`, `ENTERPRISE`. |
| `quotaId` | `string` | Yes | The quota whose limit it asks to raise, such as resourcemanager.projects. |
| `requester` | `string` | Yes | Who asked: user:usr_… or serviceAccount:sa_…. |
| `state` | `string` | Yes | PENDING until kosem answers; APPROVED, with the limit kosem set (grantedLimit), which may differ from the one asked; or DECLINED, saying why (answer). Values: `PENDING`, `APPROVED`, `DECLINED`. |
| `usage` | `integer (int64)` | Yes | How many the organization had when it asked. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.