Add allowed IPs

POST

/ipaware/{hostname}/allowed_ips

Last modified:2026-10-09 00:59:36

OperationId:addAllowedIp

Adds addresses or CIDR ranges to the allow list on one server, or updates the comment and expiry of an entry that is already there. The entry applies on that server at once, and any firewall block it covers is lifted. The other servers in the cluster receive it shortly after. Requires Super User scope.

Send the address in the body, or in the cidr query parameter. Send an array, or repeat the query parameter, to add several in one call; each is applied on its own and the answer reports each one, with 207 when any failed. Match-all ranges such as 0.0.0.0/0 are refused.

The request goes to the IP rules service on {hostname}, and its status and body come back unchanged. Errors the API decides itself use the code and message form; errors from the service use the error form.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Every entry was stored. One value answers with its result, an array with the batch result.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴503Service Unavailable

🟠404Not Found

🟢207Multi-Status

Request Example

Shell

JavaScript

Java

Swift

cURL

Customer subnetOne address for an hourBatch

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/ipaware//allowed_ips?cidr=198.51.100.0%2F24&comment=Customer%20SBC&ttl=3600' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "cidr": "198.51.100.0/24",
    "comment": "Customer SBC"
}'

Response Example

200 - Customer subnet

{
    "status": "added",
    "cidr": "198.51.100.0/24",
    "store": "db"
}

Modified at 2026-10-09 00:59:36

List allowed IPs

Remove allowed IPs