Update domain route profile

PUT

/domains/{domain}/routeprofiles/{connection-id}

Last modified:2026-09-26 18:00:58

OperationId:updateDomainRouteProfile

Changes a route profile's description, or its route and route connections. Requires Office Manager, Route Manager, or Call Center Supervisor scope in the domain, Reseller scope in its territory, or Super User scope. The API publishes the profile on the service bus (SBUS) connection_events channel and any route change on NmsRoute, so 202 means published, not applied.

The path identifies the profile. A profile in another domain, or an ordinary connection, returns 404. Send only what changes. call-routing updates the route this profile already points at, whatever address the body names. An omitted route-method, route-is-enabled, or description keeps its stored value. Each routecon entry is written by route-connection-ordinal-index, and an entry without an index is added after the stored ones. Connections you leave out are kept; remove one with DELETE /routes/{route-id}/routecon/{index}. call-routing is checked before anything is published, as on create. synchronous is ignored.

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

Examples

Responses

🟢202Accepted

application/json

The change was published on the SBUS. It is applied after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/routeprofiles/dG9sbGZyZWU' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "Toll-free outbound chain (updated)"
}'

Response Example

202 - Rename

The change was published.

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

Modified at 2026-09-26 18:00:58

Read domain route profile

Delete domain route profile