Unblock IP addresses

POST

/ipaware/{hostname}/firewall/unblock

Last modified:2026-10-09 01:00:38

OperationId:unblockIp

Removes firewall blocks on one server and clears any cached refusal for the addresses, so they are allowed again at once. The other servers in the cluster receive the change shortly after. Requires Super User scope.

Send the address in the body, or in the ip query parameter. Send an array, or repeat the query parameter, to unblock several in one call. Set reset to also clear the address's scan history, so it is judged afresh. An unblocked address can be blocked again by a later detection. To keep it from ever being blocked, add it with POST /ipaware/{hostname}/allowed_ips.

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 address was processed. An address that was not blocked answers not_blocked, not an error.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Internal Server Error

🟠404Not Found

🔴503Service Unavailable

🟢207Multi-Status

Request Example

Shell

JavaScript

Java

Swift

cURL

One address, fresh startBatch

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/ipaware//firewall/unblock?ip=203.0.113.9&reset=1' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "ip": "203.0.113.9",
    "reset": true
}'

Response Example

200 - One address, fresh start

{
    "ip": "203.0.113.9",
    "cachePurged": true,
    "historyForgotten": true,
    "status": "unblocked"
}

Modified at 2026-10-09 01:00:38

Block IP addresses

Read service code