Update user device

Changes a device's SIP and provisioning settings. Send only the fields you want to change.

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. Moving the device to another user needs the same right over the new owner.

The change is published over the service bus (SBUS) and applied shortly after, so the answer is 202. Sending back the masked password you read keeps the stored one. Any other value that looks like a mask, such as ********, returns 400: send the real password or leave the field out. When you send device-provisioning-mac-address with device-models-model, the phone link is updated too; a phone registered to another domain returns 404.

check-sync: yes also reboots the device after the update is applied, so the phone fetches a configuration that already has your change. no, false, 0, and off reboot nothing. To reboot without changing anything, use POST /domains/{domain}/users/{user}/devices/{device}/reboot.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

application/json

The update was published and is applied shortly after. With check-sync: yes, the reboot request was published after it.

Bodyapplication/json

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" }'

Request

Responses