Delete site

DELETE

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

Last modified:2026-09-27 18:53:25

OperationId:DeleteSite

Deletes a site: the system extension that holds its settings, and the records that extension owns.

Requires Office Manager in the domain, Reseller for a domain in your territory, or Super User. Site Manager, Basic User, Super User Read Only, and every other scope get 403.

A site that still has members is refused with 409, and the message gives how many. Members are the users, call queues, and other extensions filed under the site. Move them first, or send force=yes to clear the site from every member and then delete it. Members keep their own settings, including values they copied from the site when they were created, and their devices are not touched.

Deleting the site also removes what its own extension owns: its devices, time frames, emergency addresses, contacts, conferences, recording settings, and CDR schedules, among other records. Phone numbers routed to the site's extension return to inventory. The site's group chat is archived last, after everything else succeeds. The site's provisioning defaults are not removed.

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. DELETE /domains/{domain}/sites, with no name in the path, returns 405.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟠404Record Not Found

application/json

No site has this name in the domain, or the domain does not exist. Check the name with GET /domains/{domain}/sites.

Bodyapplication/json

🟠409

🟢202Accepted

🟠401Authentication Required

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/sites/Main Office?force=yes' \
--header 'Authorization: Bearer <token>'

Response Example

404 - Example 1

{
    "code": 0,
    "message": "string"
}

Modified at 2026-09-27 18:53:25

Read site

List call queues