Update route

PUT

/routes/{route-id}

Last modified:2026-10-30 21:27:50

OperationId:UpdateRoute

Changes a route's description, route-method, or route-is-enabled. Requires Super User scope. A route's match fields cannot change: to move a route to another pattern, create the new route and its connections, then delete the old one.

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

🟢200OK

application/json

Returned for synchronous=yes, sent in the body or the query string, when the change is applied within 2 seconds: the route. If it takes longer, you get 202 and the write still completes.

Bodyapplication/json

🟢202Accepted

🟠404

🟠400

🟠401

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Switch to least costDisable

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/routes/c2lwOjE4MDAqQCo' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "Toll-free outbound, least cost",
    "route-method": "cost"
}'

Response Example

200 - Disable

The route after the change.

{
    "route-destination-match-pattern": "sip:1800*@*",
    "route-source-match-pattern": "*",
    "route-class": "*",
    "route-match-server-hostname": "*",
    "route-is-enabled": "no",
    "description": "Toll-free outbound",
    "route-method": "cost",
    "route-id": "c2lwOjE4MDAqQCo"
}

Modified at 2026-10-30 21:27:50

Create route connection

Update route connection