Delete phone in domain

DELETE

/domains/{domain}/phones

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

OperationId:DeletePhoneInDomain

Removes a phone in the domain from the Endpoints server inventory, found by device-provisioning-mac-address in the body or query string. The phone's own configuration (/domains/{domain}/phoneconfiguration/{mac}) is removed with it. To free one line instead of removing the phone, also send id (the device on that line) and user (its owner). If that device is on line 2 or higher, only that line is cleared and the phone stays. On line 1, or when the device's line cannot be found, the whole phone is removed.

Requires Office Manager, Reseller, or Super User scope. Site Manager can remove phones whose line 1 belongs to a user in its site. Basic User and the other user scopes can remove only their own phone, the one whose line 1 they own. A phone filed in a domain other than the one you name returns 404.

The response is 202: the removal is accepted and applied shortly after. The devices on the phone's lines are not removed.

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.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

Remove phoneFree line 2

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//phones' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device-provisioning-mac-address": "00005e005301"
}'

Response Example

202 - Remove phone

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

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

Delete phone

Read phone configuration file in domain