Replace the complete Central IP allowlist. PUT /api/openapi/v1/network-ranges, scope admin.v1.trusted-network.manage.
- Scope: admin.v1.trusted-network.manage
- Permission: Manage trusted networks (trusted-network)
- Permission type: Manage
- Endpoint: PUT/api/openapi/v1/network-ranges
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 |
|---|---|---|---|---|---|
| ip_whitelist | body | array<string> | Required | IP addresses or CIDR ranges. CIDRs with host bits are normalized to their network address, preserving the prefix length (42.120.72.78/16 becomes 42.120.0.0/16). Duplicate normalized entries are rejected. | ["<string>"] |
Request example
cURL
Responses
200 OK
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| success | boolean | Yes | - | false |
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>" |