Update domain

PUT

/domains/{domain}

Last modified:2026-10-08 23:04:16

OperationId:UpdateDomain

Changes a domain. Send only the fields to change. Requires Office Manager scope for your own domain, Reseller scope for a domain in your territory, or Super User scope. Setting recording-configuration requires Reseller scope or above.

The time zone, dial plan, dial permission, caller ID, area code, language, and voicemail defaults are also written to the domain user, so users created afterward get the new values. Existing users keep theirs. Changing reseller also moves the domain's devices to the new territory.

A 202 means the change is accepted and applied shortly after.

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 is accepted and applied shortly after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Change time zone and caller IDLock the domain

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "time-zone": "US/Central",
    "caller-id-number": "15555550102"
}'

Response Example

202 - Accepted

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

Modified at 2026-10-08 23:04:16

Read domain

Delete domain