Update domain connection

PUT

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

Last modified:2026-10-09 00:41:54

OperationId:UpdateDomainConnection

Changes a connection of the domain. 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 change on the service bus (SBUS) connection_events channel, and each server applies it when the event arrives, so 202 means published, not applied.

The path identifies the connection. A connection-orig-match-pattern in the body or query string is ignored, so the key cannot be renamed. An id that names no connection in this domain returns 404. A route profile's id keeps its route-name address and its route_profile type: a different connection-connectivity-type returns 400, and a different connection-address is ignored with a Warning header. Send only what changes. Omitted fields keep their stored values, the call-processing fields such as connection-sip-transport-protocol included. Changing connection-connectivity-type also sets connection-sip-authenticate-as-client-enabled and reformats connection-address to suit the type. An invalid connection-connectivity-type, connection-require-encrypted-audio-enabled, or connection-sip-session-timer-enabled returns 400. Sending call-routing returns 404: change a route profile's route through the route-profile endpoints. 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/json

Examples

Responses

🟢202Accepted

application/json

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

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Not Found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Change descriptionSwitch to TLSLimit calls

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//connections/c2lwOipAMTkyLjAuMi4xMA' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "changed description!",
    "connection-source-ip-checking-enabled": "no",
    "connection-include-server-header-enabled": "yes"
}'

Response Example

202 - Success

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

Modified at 2026-10-09 00:41:54

Delete domain connection

Create domain connection