Create route connection

POST

/routes/{route-id}/routecon

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

OperationId:CreateRouteConnection

Adds a route connection, one next hop, to the route that route-id names. Requires Super User scope. The API does not check that the route exists, so list routes with GET /routes first.

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 connection is applied within 2 seconds: every connection of 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

Next indexChosen index

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/routes/c2lwOjE4MDAqQCo/routecon' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "route-connection-translation-destination-host": "carrier1.example.com",
    "route-connection-integer-percentage": 60,
    "route-connection-integer-cost": 0
}'

Response Example

200 - Chosen index

The route's connections after the write.

[
    {
        "route-destination-match-pattern": "sip:1800*@*",
        "route-source-match-pattern": "*",
        "route-class": "*",
        "route-match-server-hostname": "*",
        "route-connection-ordinal-index": 1,
        "route-connection-translation-destination-user": "[*]",
        "route-connection-translation-destination-host": "carrier1.example.com",
        "route-connection-integer-percentage": 60,
        "route-connection-integer-cost": 0
    },
    {
        "route-destination-match-pattern": "sip:1800*@*",
        "route-source-match-pattern": "*",
        "route-class": "*",
        "route-match-server-hostname": "*",
        "route-connection-ordinal-index": 2,
        "route-connection-translation-destination-user": "[*]",
        "route-connection-translation-destination-host": "carrier2.example.com",
        "route-connection-integer-percentage": 40,
        "route-connection-integer-cost": 0
    }
]

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

Create route

Update route