Skip to Content
kosemdocs
ReferenceAPIQuota increase requests

Get quota increase request

Gets one of an organization's quota increase requests, with kosem's answer once it has one.

GET
/v1/organizations/{organization}/quotaIncreaseRequests/{quotaIncreaseRequest}

Gets one of an organization's quota increase requests, with kosem's answer once it has one.

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}$
quotaIncreaseRequest*string

The request's ID.

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

Response Body

OK

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 GET 'https://api.kosem.ai/v1/organizations/string/quotaIncreaseRequests/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
}