Delete user device

DELETE

/domains/{domain}/users/{user}/devices/{device}

Last modified:2026-10-08 23:06:58

OperationId:DeleteDevice

Deletes a device and its call recording configuration.

Requires Basic User for your own devices, or Site Manager, Office Manager, Reseller, or Super User for the users you administer. A device that does not exist returns 404. A full SIP URI in the path must name the path domain; a device in another domain returns 404. On the user path, a device that belongs to a different user returns 404. A Basic User or other user-level scope acting on someone else's device, or a Site Manager acting on a device outside its site, gets 403.

The delete is published over the service bus (SBUS) and applied shortly after, so the answer is 202. The device's recording configuration is removed at once. A phone linked to the device keeps its provisioning entry.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢202Accepted

application/json

The delete was published and is applied shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//devices/1001a' \
--header 'Authorization: Bearer <token>'

Response Example

202 - Accepted

The delete was published.

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

Modified at 2026-10-08 23:06:58

Update user device

Read user device