Update route profile

PUT

/routeprofiles/{connection-id}

Last modified:2026-09-26 18:01:25

OperationId:updateRouteProfile

Changes a route profile by connection-id, without naming its domain. Requires Super User or Reseller scope. A Reseller can change only a profile in its own territory; other scopes use PUT /domains/{domain}/routeprofiles/{connection-id}. The API publishes on the service bus (SBUS) connection_events channel and, for route changes, NmsRoute, so 202 means published, not applied.

An id outside your territory, or the id of 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

Patch description onlyRename

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/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:01:25

Read route profile

Delete route profile