Add or update an allowed IP/CIDR

POST

/ipaware/allowed_ips

Last modified:2026-07-18 16:57:06

OperationId:addAllowedIp

Upsert: adding an existing entry updates its comment/TTL. Accepts a single IPv4 or IPv6 address or a CIDR. Match-all forms (*, 0.0.0.0/0, ::/0) are refused. Parameters may come from the JSON body or from query parameters (?cidr=&comment=&ttl=). The entry takes effect immediately on this host (active firewall blocks it covers are lifted) and fleet-wide within the DB poll interval.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Entry added or updated.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

Customer SBC subnetSingle IP for one hourIPv6 CIDR

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

Response Example

200 - Success Example

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

Modified at 2026-07-18 16:57:06

List allowed IPs

Remove an allowed IP/CIDR