Reset configuration key

DELETE

/ipaware/{hostname}/config/{key}

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

OperationId:deleteConfigKey

Removes one key from the configuration file of the IP rules service on one server, so the key goes back to its default. Requires Super User scope. The default takes effect at once for a key in liveKeys, and after a restart for any other.

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

Responses

🟢200OK

application/json

The key was removed from the file.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠429Too Many Requests

🔴500Internal Server Error

🔴501Not Implemented

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/ipaware//config/firewall_block_ttl' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Reset to default

{
    "status": "updated",
    "updated": {},
    "removed": [
        "firewall_block_ttl"
    ],
    "effects": [
        {
            "key": "firewall_block_ttl",
            "value": 604800,
            "removed": true,
            "effect": "restart"
        }
    ],
    "applied": [],
    "pending": [
        {
            "key": "firewall_block_ttl",
            "running": 86400,
            "file": 604800
        }
    ],
    "restartRequired": true
}

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

Update configuration key

Restart service