Update dial rule

PUT

/domains/{domain}/dialplans/{dialplan}/dialrules/{dialrule}

Last modified:2026-10-08 22:59:39

OperationId:UpdateDialrule

Updates a dial rule's routing: its application, parameter, destination, caller ID translation, enabled state, or description. Requires Basic User, Site Manager, Office Manager, Reseller, or Super User scope. A Reseller reaches only domains in its territory; every other scope reaches only its own domain.

Send only the fields to change; the others keep their current values. The match fields (dial-rule-matching-*) make up the dialrule id, so this endpoint cannot change them and ignores any in the body. To change what a rule matches, delete it and create a new one.

The response is 202: the change is published, not yet applied, so a read straight after it may not show the change yet. An unknown dialrule id returns 404.

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/json

Examples

Responses

🟢202Accepted

application/json

The change is published and applied within a few seconds.

Bodyapplication/json

🟠404

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//dialplans//dialrules/c2lwOjYxMUAq' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "dial-rule-translation-destination-user": "2600",
    "dial-rule-description": "611 - Support queue"
}'

Response Example

202 - Change destination

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-08 22:59:39

Read dial rule

Delete dial rule