Skip to Content
kosemdocs
ReferenceAPIQuota increase requests

Create quota increase request

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.

POST
/v1/organizations/{organization}/quotaIncreaseRequests

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.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Path Parameters

organization*string

The organization's ID.

Match^org_[0-7][0-9a-hjkmnp-tv-z]{25}$

Request Body

application/json
  1. body
desiredLimit*integer

The limit to ask for, more than the one now.

Formatint64
Range1 <= value
justification*string

What the organization needs it for, such as the work it runs, which kosem's team reads to decide.

Length1 <= length <= 2000
quotaId*string

The quota whose limit to raise, such as resourcemanager.projects: one whose quota info's adjustment is REQUEST.

Match^[a-z][a-zA-Z0-9]*(\.[a-z][a-zA-Z0-9]*)+$

Response Body

Created

application/json
  1. response
answer?string

What kosem wrote back, if anything; always with a decline.

createTime*string

When it was asked.

Formatdate-time
decideTime?string

When kosem approved or declined it; absent while pending.

Formatdate-time
desiredLimit*integer

The limit it asked for.

Formatint64
displayName*string

The quota's name, such as Concurrent vCPUs.

grantedLimit?integer

The limit kosem set, once approved.

Formatint64
justification*string

What the organization needs it for, as it wrote.

limit*integer

The organization's limit when it asked.

Formatint64
name*string

Resource name, organizations/{organization_id}/quotaIncreaseRequests/{quota_increase_request_id}.

plan*string

The plan it was asked on. An approved limit applies while the organization stays on it.

Value in"TEAM""ENTERPRISE"
quotaId*string

The quota whose limit it asks to raise, such as resourcemanager.projects.

requester*string

Who asked: user:usr_… or serviceAccount:sa_….

state*string

PENDING until kosem answers; APPROVED, with the limit kosem set (grantedLimit), which may differ from the one asked; or DECLINED, saying why (answer).

Value in"PENDING""APPROVED""DECLINED"
usage*integer

How many the organization had when it asked.

Formatint64
Example Request
curl -X POST 'https://api.kosem.ai/v1/organizations/string/quotaIncreaseRequests' \
  -H 'Content-Type: application/json' \
  -d '{
  "desiredLimit": 1,
  "justification": "string",
  "quotaId": "string"
}'
Example Response
{
  "answer": "string",
  "createTime": "2019-08-24T14:15:22Z",
  "decideTime": "2019-08-24T14:15:22Z",
  "desiredLimit": 0,
  "displayName": "string",
  "grantedLimit": 0,
  "justification": "string",
  "limit": 0,
  "name": "string",
  "plan": "TEAM",
  "quotaId": "string",
  "requester": "string",
  "state": "PENDING",
  "usage": 0
}