Delete an NMS configuration entry

DELETE

/nmsconfig/{config-name}

Last modified:2026-08-27 05:36:57

OperationId:DeleteNmsConfig

Delete a configuration key.

Replicates by default; config-server deletes it on one server only, with the same caveats as an update. The delete is keyed on the configuration name alone — any other field in the body is ignored rather than becoming an additional match condition.

With verify=yes, a server reports config-applied: yes once it no longer holds the key.

Requires the Super User scope.

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

Accepted. Without verify=yes this is the bare {code, message} acknowledgement; with it, a per-server report.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴502Peer Unreachable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/nmsconfig/SMTP_HOST?verify=undefined&verify-timeout=undefined' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "config-server": "core1.example.com"
}'

Response Example

200 - Example 1

{
    "code": 0,
    "message": "string"
}

Modified at 2026-08-27 05:36:57

Update an NMS configuration entry

Read a Specific Configuration