Update phone

PUT

/phones

Last modified:2026-10-30 20:56:04

OperationId:UpdatePhone

Changes a phone, found by device-provisioning-mac-address in the body. Send only the fields to change. Requires Office Manager, Reseller, or Super User scope. A Site Manager reaches phones whose line 1 belongs to a user in its site, and Basic User and the other user scopes only their own phone, the one whose line 1 they own.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

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

Add second lineSet overrides

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/phones' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device-provisioning-mac-address": "00005e005301",
    "device-provisioning-sip-uri-2": "sip:1002a@example.com",
    "device-provisioning-sip-transport-protocol": "tls",
    "notes": "Front Desk, second line added"
}'

Response Example

202 - Add second line

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

Modified at 2026-10-30 20:56:04

Add phone in domain

Update phone in domain