Update site

PUT

/domains/{domain}/sites/{site}

Last modified:2026-10-08 23:11:50

OperationId:UpdateSiteInDomain

Changes a site's settings. Send only the fields to change.

Requires Office Manager in the domain, Reseller for a domain in your territory, or Super User. A Site Manager can update only the site it belongs to, and gets 403 for any other. Basic User, Super User Read Only, and every other scope get 403.

The name is the key and cannot be changed. A site in the body is ignored. To rename a site, create the new one, move its members to it, and delete the old one.

The update writes the site's own settings only. Users and call queues already filed under the site keep the values they copied from it when they were created.

A 202 means the change was published over the service bus (SBUS), not yet applied. Each core server applies it when the event arrives, so a read straight after the 202 can still show the old state. synchronous is ignored.

A name with no site returns 404, including a site created a moment ago whose create is not applied yet. PUT /domains/{domain}/sites, with no name in the path, returns 405.

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 over the service bus and will be applied on each core server.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Change caller ID and time zone

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//sites/Main Office' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "synchronous": "no",
    "site": "New York"
}'

Response Example

202 - Accepted

The change was published.

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

Modified at 2026-10-08 23:11:50

Create site

Read site