Create individual quota. POST /api/openapi/v1/individual-quota-configs, scope admin.v1.quota.manage.
- Scope: admin.v1.quota.manage
- Permission: Manage quotas and metering (quota)
- Permission type: Manage
- Endpoint: POST/api/openapi/v1/individual-quota-configs
Authentication and request headers
Call with an application API key. This endpoint checks only the scope above; read, manage and execute permissions do not imply one another.
| Name | Location | Type | Required | Description | Example |
|---|---|---|---|---|---|
| Authorization | header | string | Yes | Application API key, passed as a Bearer token. | Bearer qwk_*** |
| X-Request-Id | header | string | No | Optional request tracing identifier; generated by the server if omitted. | req-20260831-001 |
Request parameters
| Name | Location | Type | Required | Description | Example |
|---|---|---|---|---|---|
| per_user_limit | body | integer · int64 | Required | Credit limit per user per cycle | 500 |
| user_id | body | string | Required | User ID | "<string>" |
| validity | body | string | No | Validity | "permanent" |
Request example
cURL
Responses
201 Created
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| item | OpenapifacadeIndividualQuota | Yes | Record details | {"created_at":"2026-08-27T10:00:00Z","created_by":"<string>","expires_at":"2026-08-27T10:00:00Z","id":"<string>","per_user_limit":0,"revision":0,"updated_at":"2026-08-27T10:00:00Z","updated_by":"<string>","user_id":"<string>","validity":"permanent"} |
| item.created_at | string · date-time | Yes | Created at | "2026-08-27T10:00:00Z" |
| item.created_by | string | Yes | Creator ID | "<string>" |
| item.expires_at | string ｜ null · date-time | Yes | Expires at | "2026-08-27T10:00:00Z" |
| item.id | string | Yes | Record ID | "<string>" |
| item.per_user_limit | integer · int64 | Yes | Credit limit per user per cycle | 0 |
| item.revision | integer · int64 | Yes | Read-only configuration revision; customer updates and deletes do not require this value. | 0 |
| item.updated_at | string · date-time | Yes | Updated at | "2026-08-27T10:00:00Z" |
| item.updated_by | string | Yes | Updater ID | "<string>" |
| item.user_id | string | Yes | User ID | "<string>" |
| item.validity | string | Yes | Validity | "permanent" |
default Flat business error
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| code | string | No | Stable business error code | "<string>" |
| detail | string | Yes | Human-readable error description | "<string>" |
| details | OpenapiErrorDetails | No | Error details | {"field":"<string>","reason":"<string>","suggestion":"<string>"} |
| details.field | string | No | Request field that failed validation | "<string>" |
| details.reason | string | No | Stable validation failure reason | "<string>" |
| details.suggestion | string | No | Suggested normalized value | "<string>" |
| error | string | Yes | Stable HTTP error type | "<string>" |