Update a device - Zoom API

Update information of a desk phone device.

Prerequisites:

Pro or a higher account with Zoom Phone license

Account owner or admin permissions
Scopes: phone:write:admin

Rate Limit Label: Light

请求参数

Path 参数

deviceId

string

必需

Unique Identifier of the Device.

Body 参数multipart/form-data

assigned_to

string

可选

User ID or email address of the user to whom this device is to be assigned. The User ID and the email of the user can be retrieved using the List Users API.

display_name

string

可选

Display name of the desk phone.

<= 255 字符

mac_address

string

可选

The MAC address of the desk phone.

Note: If you're using a wireless phone, enter the wired MAC address, not the wireless MAC address.

正则匹配:

^([0-9A-Fa-f]{2}[:-]?){5}([0-9A-Fa-f]{2})$

返回响应

🟢204**HTTP Status Code:** `204` **No Content** Device updated successfully.

application/json

Body

No schema defined

🟠400**HTTP Status Code:** `400` **Bad Request** **Error Code:** `300` Validation failed. Device does not exist in the system. Invalid userId.

🟠404**HTTP Status Code:** `404` **Not Found** **Error Code:** `1001` User not found: {userId} The user extension does not exist, extensionId: {extensionId}.

🟠429**HTTP Status Code:** `429` **Too Many Requests** **Error Code:** `429` Each user can be assigned up to three desk phones.