Create an NMS configuration entry

POST

/nmsconfig

Last modified:2026-08-26 23:03:15

OperationId:CreateNmsConfig

Create a new configuration key.

Answers 409 if the key already exists — the underlying write is an upsert, so without that check a POST over an existing key would silently rewrite it. Pass overwrite=yes to allow it. The check is best-effort rather than a lock: the row lives on every server and another one could be writing at the same time.

See PUT /nmsconfig/{config-name} for how config-server and verify work; they behave identically here.

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 ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

201 - Example 1

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

Modified at 2026-08-26 23:03:15

List NMS configuration entries

Count NMS configuration entries