ZITADEL Docs
APIsCore ResourcesV1Instance Lifecycle

AddQuota

Creates a new quota Returns an error if the quota already exists for the specified unit Deprecated: use SetQuota instead

POST
/instances/{instance_id}/quotas

Path Parameters

instance_id*string

Request Body

application/json

unit?string

the unit a quota should be imposed on

Value in"UNIT_UNIMPLEMENTED" | "UNIT_REQUESTS_ALL_AUTHENTICATED" | "UNIT_ACTIONS_ALL_RUN_SECONDS"
from?string

the starting time from which the current quota period is calculated from. This is relevant for querying the current usage.

Formatdate-time
resetInterval?string

the quota periods duration

Formatduration
amount?integer|string

the quota amount of units

Formatint64
limit?boolean

whether Zitadel should block further usage when the configured amount is used

notifications?

the handlers, Zitadel executes when certain quota percentages are reached

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/instances/string/quotas" \  -H "Content-Type: application/json" \  -d '{}'
{
  "details": {
    "sequence": 0,
    "creationDate": "1s",
    "changeDate": "1s",
    "resourceOwner": "string"
  }
}
{
  "code": "not_found",
  "message": "string",
  "detail": {
    "type": "string",
    "value": "string",
    "debug": {}
  }
}

Was this page helpful?