Zoom API
  1. Users
Zoom API
  • Accounts
    • List sub accounts
      GET
    • Create a sub account
      POST
    • Disassociate a sub account
      DELETE
    • Get sub account details
      GET
    • Get locked settings
      GET
    • Update locked settings
      PATCH
    • Get managed domains
      GET
    • Update options
      PATCH
    • Update the account owner
      PUT
    • Get settings
      GET
    • Update settings
      PATCH
    • Delete virtual background files
      DELETE
    • Upload virtual background files
      POST
    • Get trusted domains
      GET
  • Billing
    • Get billing information
    • Update billing information
    • List billing invoices
    • Get invoice details
    • Get plan Information
    • Subscribe plans
    • Subscribe additional plan
    • Update an additional plan
    • Cancel additional plans
    • Update a base plan
    • Cancel a base plan
    • Get plan usage
    • Download an invoice file
  • Phone
    • Update BYOC settings
    • Set up a Zoom Phone account
    • Assign SIP trunks
    • Update SIP trunk details
    • Add BYOC phone numbers
    • Get account's call logs
    • List calling plans
    • Change main company number
    • List phone numbers
    • Get phone number details
    • Update phone number details
    • Get call recordings
    • List setting templates
    • Add a setting template
    • Get setting template details
    • Update a setting template
    • List BYOC SIP trunks
    • List phone users
    • Get user's profile
    • Update user's profile
    • Get user's call logs
    • Delete a user's call log
    • Assign calling plan to a user
    • Unassign user's calling plan
    • Assign phone number to user
    • Unassign phone number
    • Get user's recordings
    • Get user's settings
    • Remove shared access
    • Update shared access
    • Set up shared access
    • Get user's voicemails
    • Delete a voicemail
  • Cloud Recording
    • List recordings of an account
    • List archived files
    • Delete meeting recordings
    • Get meeting recordings
    • List recording registrants
    • Create a recording registrant
    • Get registration questions
    • Update registration questions
    • Update registrant's status
    • Get meeting recording settings
    • Update meeting recording settings
    • Recover meeting recordings
    • Delete a meeting recording file
    • Recover a single recording
    • List all recordings
  • SIP Connected Audio
    • List internal call-out countries
    • Add internal call-out countries
    • Delete internal call-out country
    • List internal numbers
    • Add internal numbers
    • Delete an internal number
    • Delete all numbers
    • Assign numbers
    • Assign SIP trunk configuration
    • List SIP trunks
    • Assign SIP trunks
    • Delete a SIP trunk
    • List SIP trunk numbers
  • Users
    • Switch a user's account
      PUT
    • List users
      GET
    • Create users
      POST
    • Check a user email
      GET
    • Get user's ZAK
      GET
    • Check a user's PM room
      GET
    • Delete a user
      DELETE
    • Get a user
      GET
    • Update a user
      PATCH
    • Delete user assistants
      DELETE
    • List user assistants
      GET
    • Add assistants
      POST
    • Delete a user assistant
      DELETE
    • Update a user's email
      PUT
    • Update a user's password
      PUT
    • Get user permissions
      GET
    • Upload a user's profile picture
      POST
    • Update a user's presence status
      PUT
    • Delete user schedulers
      DELETE
    • List user schedulers
      GET
    • Delete a scheduler
      DELETE
    • Get user settings
      GET
    • Update user settings
      PATCH
    • Delete virtual background files
      DELETE
    • Upload virtual background files
      POST
    • Update user status
      PUT
    • Revoke a user's SSO token
      DELETE
    • Get a user token
      GET
  • Chat Channels
    • Delete a channel
    • Get a channel
    • Update a channel
    • Leave a channel
    • Join a channel
    • Remove a member
    • List user's channels
    • Create a channel
  • Contacts
    • List user's contacts
    • Get user's contact details
    • Search company contacts
  • Chat Channels (Account-level)
    • Delete a channel
    • Get a channel
    • Update a channel
    • List channel members
    • Invite channel members
    • Remove a member
  • Chat Messages
    • List user's chat messages
    • Send a chat message
    • Delete a message
    • Update a message
  • Groups
    • List groups
    • Create a group
    • Delete a group
    • Get a group
    • Update a group
    • Get locked settings
    • Update locked settings
    • List group members
    • Add group members
    • Delete a group member
    • Update a group member
    • Get a group's settings
    • Update a group's settings
    • Delete virtual background files
    • Upload virtual background files
  • Devices
    • List H.323/SIP devices
    • Create a H.323/SIP device
    • Delete a H.323/SIP device
    • Update a H.323/SIP device
  • Chatbot Messages
    • Send chatbot messages
    • Delete a chatbot message
    • Edit a chatbot message
  • IM Chat
    • Get IM chat sessions
    • Get IM chat messages
    • Send IM messages
    • Get user’s IM messages
  • IM Groups
    • List IM directory groups
    • Create an IM directory group
    • Delete an IM directory group
    • Retrieve an IM directory group
    • Update an IM directory group
    • List IM directory group members
    • Add IM directory group members
    • Delete an IM directory group member
  • Meetings
    • Use in-Meeting recording controls
    • Delete a meeting
    • Get a meeting
    • Update a meeting
    • Perform batch poll creation
    • Get meeting invitation
    • Get live stream details
    • Update a live stream
    • Update Live Stream Status
    • List meeting polls
    • Create a meeting poll
    • Delete a meeting poll
    • Get a meeting poll
    • Update a meeting poll
    • List meeting registrants
    • Add meeting registrant
    • List registration questions
    • Update registration questions
    • Update registrant's status
    • Delete a meeting registrant
    • Update meeting status
    • List ended meeting instances
    • List past meeting's poll results
    • Get past meeting details
    • Get past meeting participants
    • List meeting templates
    • List meetings
    • Create a meeting
  • Dashboards
    • List Zoom meetings client feedback
    • Get zoom meetings client feedback
    • List client meeting satisfaction
    • Get CRC port usage
    • Get IM metrics
    • Get top 25 Zoom Rooms with issues
    • Get issues of Zoom Rooms
    • List meetings
    • Get meeting details
    • List meeting participants
    • List meeting participants QoS
    • Get post meeting feedback
    • Get sharing/recording details
    • Get meeting participant QoS
    • List webinars
    • Get webinar details
    • Get webinar participants
    • List webinar participant QoS
    • Get post webinar feedback
    • Get sharing/recording details
    • Get webinar participant QoS
    • List Zoom Rooms
    • Get top 25 issues of Zoom Rooms
    • Get Zoom Rooms details
    • List call logs
    • Get call QoS
    • Get call details from call log
  • Deprecated API Endpoints
    • List past meeting's files
    • List past webinar files
  • Webinars
    • Get webinar absentees
    • List past webinar instances
    • List webinar participants
    • List past webinar poll results
    • List Q&A of past webinar
    • List webinar templates
    • List webinars
    • Create a webinar
    • Delete a webinar
    • Get a webinar
    • Update a webinar
    • Perform batch registration
    • Remove panelists
    • List panelists
    • Add panelists
    • Remove a panelist
    • List a webinar's polls
    • Create a webinar's poll
    • Delete a webinar poll
    • Get a webinar poll
    • Update a webinar poll
    • List webinar registrants
    • Add a webinar registrant
    • List registration questions
    • Update registration questions
    • Update registrant's status
    • Delete a webinar registrant
    • Get a webinar registrant
    • Update webinar status
    • Get webinar tracking sources
  • Phone Auto Receptionists
    • Add an auto receptionist
    • Update auto receptionist details
    • Unassign all phone numbers
    • Assign phone numbers
    • Unassign a phone number
  • Phone Blocked List
    • List blocked lists
    • Create a blocked list
    • Delete a blocked list
    • Get blocked list details
    • Update a blocked list
  • Phone Call Queues
    • List call queues
    • Create a call queue
    • Delete a call queue
    • Get call queue details
    • Update call queue details
    • Change call queue manager
    • Unassign all members
    • Add members to a call queue
    • Unassign a member
    • Unassign all phone numbers
    • Assign numbers to a call queue
    • Unassign a phone number
    • Get call queue recordings
  • Common Area Phones
    • List common area phones
    • Add a common area phone
    • Delete a common area phone
    • Get common area phone details
    • Update common area phone
  • Phone Devices
    • List devices
    • Add a device
    • Delete a device
    • Get device details
    • Update a device
  • Phone Reports
    • Get operation logs report
  • Phone Shared Line Groups
    • List shared line groups
    • Create a shared line group
    • Delete a shared line group
    • Get a shared line group
    • Update a shared line group
    • Unassign members of a shared line group
    • Add members to a shared line group
    • Unassign a member from a shared line group
    • Assign phone numbers
    • Unassign a phone number
  • Phone Site
    • List phone sites
    • Create a phone site
    • Delete a phone site
    • Get phone site details
    • Update phone site details
  • Reports
    • Get sign In / sign out activity report
    • Get cloud recording usage report
    • Get daily usage report
    • Get meeting detail reports
    • Get meeting participant reports
    • Get meeting poll reports
    • Get operation logs report
    • Get telephone reports
    • Get active/inactive host reports
    • Get meeting reports
    • Get webinar detail reports
    • Get webinar participant reports
    • Get webinar poll reports
    • Get webinar Q&A report
  • Roles
    • List roles
    • Create a role
    • Delete a role
    • Get role information
    • Update role information
    • List members in a role
    • Assign a role
    • Unassign a role
  • Rooms
    • List Zoom Rooms
    • Add a Zoom Room
    • List digital signage contents
    • Update E911 digital signage
    • Check-in or check-out of a Zoom Room
    • Delete a Zoom Room
    • Get Zoom Room profile
    • Update a Zoom Room profile
    • List Zoom Room devices
    • Change a Zoom Room's location
    • Get Zoom Room settings
    • Update Zoom Room settings
  • Rooms Account
    • Get Zoom Room account profile
    • Update Zoom Room account profile
    • Get Zoom Room account settings
    • Update Zoom Room account settings
  • Rooms Location
    • List Zoom Room locations
    • Add a location
    • Get Zoom Room location structure
    • Update Zoom Rooms location structure
    • Get Zoom Room location profile
    • Update Zoom Room location profile
    • Change the assigned parent location
    • Get location settings
    • Update location settings
  • Rooms Devices
    • Change Zoom Rooms' app version
  • SIP Phone
    • List SIP phones
    • Enable SIP phone
    • Delete SIP phone
    • Update SIP phone
  • TrackingField
    • List tracking fields
    • Create a tracking field
    • Delete a tracking field
    • Get a tracking field
    • Update a tracking field
  • TSP
    • Get account's TSP information
    • Update account's TSP information
    • List user's TSP accounts
    • Add a user's TSP account
    • Set global dial-in URL for a TSP user
    • Delete a user's TSP account
    • Get a user's TSP account
    • Update a TSP account
  • PAC
    • List a user's PAC accounts
  • Data Compliance
  • Webhooks
  • master account APIs
  1. Users

Update a user

PATCH
/users/{userId}
Users
Update information on a user's Zoom profile.

Scopes: user:write:admin user:write
Rate Limit Label: Light
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'http://api.zoom.us/v2/users/'
响应示例响应示例
204 - 示例 1
{}

请求参数

Path 参数
userId
string 
必需
The user ID or email address of the user. For user-level apps, pass me as the value for userId.
Query 参数
login_type
enum<string> 
可选
0 - Facebook.
1 - Google.
99 - API.
100 - Zoom.
101 - SSO.
枚举值:
0199100101
Body 参数multipart/form-data
cms_user_id
string 
可选
Kaltura user ID.
company
string 
可选
User's company.
<= 255 字符
custom_attributes
object 
可选
Custom attribute(s) of the user.
key
string 
可选
Identifier for the custom attribute.
name
string 
可选
Name of the custom attribute.
value
string 
可选
Value of the custom attribute.
dept
string 
可选
Department for user profile: use for report.
first_name
string 
可选
User's first name. Cannot contain more than 5 Chinese characters.
<= 64 字符
group_id
string 
可选
Provide unique identifier of the group that you would like to add a pending user to. The value of this field can be retrieved from List Groups API.
host_key
string 
可选
Host key. It should be a 6-10 digit number.
>= 6 字符<= 10 字符
job_title
string 
可选
User's job title.
<= 128 字符
language
string 
language
可选
last_name
string 
可选
User's last name. Cannot contain more than 5 Chinese characters.
<= 64 字符
location
string 
可选
User's location.
<= 256 字符
manager
string <email>
可选
The manager for the user.
phone_country
string 
可选
Note: This field has been deprecated and will not be supported in the future. Use the country field of the phone_numbers object instead to select the country for the phone number.
Country ID of the phone number. For example, if the phone number provided in the phone_number field is a Brazil based number, the value of the phone_country field should be BR.
phone_number
string 
可选
Note: This field has been deprecated and will not be supported in the future. Use the phone_numbers field instead to assign phone number(s) to a user.
Phone number of the user. To update a phone number, you must also provide the phone_country field.
phone_numbers
object 
可选
code
string 
可选
Country code of the phone number. For example, for United States phone numbers, the value of this field should be "+1".
country
string 
可选
Country ID of the phone number. For example, if the phone number provided in the number field is a Brazil based number, the value of the country field should be BR.
number
string 
可选
Phone number of the user.
pmi
integer 
可选
Personal meeting ID: length must be 10.
timezone
string 
可选
The time zone ID for a user profile. For this parameter value please refer to the ID value in the timezone list.
type
enum<integer> 
可选
User types:
1 - Basic.
2 - Licensed.
3 - On-prem.
99 - None (this can only be set with ssoCreate).
枚举值:
12399
use_pmi
boolean 
可选
Use Personal Meeting ID for instant meetings.
默认值:
false
示例值:
false
vanity_name
string 
可选
Personal meeting room name.

返回响应

🟢204**HTTP Status Code:** `204` <br> User updated.
application/json
Body
object {0}
🟠400**HTTP Status Code:** `400` **Bad Request**<br><br> **Error Code:** `200`<br>A Zoom Room user cannot be updated to a free user type: $userId<br><br> **Error Code:**`300`<br> Your request could not be completed because the name contains an invalid word: {n
🟠404**HTTP Status Code:** `404`<br> **Error Code:** `1001`<br> User does not exist: $userId.<br>

【Zoom】API开发者 微信交流群

用微信扫右侧二维码,加入【Zoom】API开发者 交流群,互助沟通

扫码加入交流群
上一页
Get a user
下一页
Delete user assistants
Built with