Update user device

PUT

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

Last modified:2026-10-30 20:55:15

OperationId:UpdateDevice

Changes a device's SIP and provisioning settings, and its phone link when you send device-provisioning-mac-address with device-models-model. Send only the fields you want to change. Requires Basic User scope for your own devices, or Site Manager, Office Manager, Reseller, or Super User scope for the users you administer. A Site Manager reaches only devices of users in its own site.

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. With check-sync: yes, the reboot follows it.

Bodyapplication/json

🟠404

🟠400

🟠401

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Change settingsChange and reboot

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//devices/1001a' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device-srtp-enabled": "no",
    "device-sip-registration-ignore-for-presence-calculation": "no",
    "device-sip-registration-expiry-seconds": 30,
    "auto_ans": "no"
}'

Response Example

202 - Accepted

The update was published.

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

Modified at 2026-10-30 20:55:15

Create user device

Delete user device