Update domain dial policy rule

PUT

/domains/{domain}/dialpolicy/{policy}/permission/{id}

Last modified:2026-10-08 23:02:31

OperationId:UpdatePermissionDomain

Changes a rule's permission-mode and permission-reason and publishes the change over the service bus (SBUS). The name resolves to the domain's own policy first, then to the shared one under * or admin-only.

Requires Office Manager scope or higher for a policy the domain owns; a Reseller needs the domain in its territory. A shared policy, one filed under * or admin-only, changes dialing for every domain, so any write to it requires Super User scope.

Send both fields. The match cannot change, because permission-id is derived from it: delete the rule and create a new one instead. A 202 means the change was published, not yet applied.

A policy or rule that the domain cannot see answers 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

Published over the service bus (SBUS), not yet applied. Each server applies the change when the event arrives, so a read straight after may still show the old value.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//dialpolicy//permission/c2lwOisxOTAwPz8_Pz8_P0Aq' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "permission-mode": "permit",
    "permission-reason": "Allowed for billing"
}'

Response Example

202 - Published

Published.

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

Modified at 2026-10-08 23:02:31

Update shared dial policy rule

Delete shared dial policy rule