Update configuration key

PUT

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

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

OperationId:updateConfigKey

Sets one configuration key of the IP rules service on one server. It works like PUT /ipaware/{hostname}/config with a single key. Requires Super User scope.

The value is checked first, and an invalid value writes nothing. A key in liveKeys takes effect at once; any other takes effect when the service restarts.

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

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The key was written.

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

NumberYes or no

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/ipaware//config/firewall_block_ttl' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "value": 86400
}'

Response Example

200 - Number

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

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

Read configuration key

Reset configuration key