Assign a role - Zoom API

User roles can have a set of permissions that allows access only to the pages a user needs to view or edit. Use this API to assign a role to members.

Scopes: role:write:admin

Rate Limit Label: Medium
Prerequisites:

A Pro or a higher plan.

请求参数

Path 参数

roleId

string

必需

The role ID

Body 参数multipart/form-data

members

array [object {2}]

可选

Array of userId/user email of users to whom you would like to assign this role. Upto 30 users can be assigned a role at once.

<= 30 items

string <email>

可选

Email address of the user to whom you would like to assign the role. Provide either the userId in the ID field or the email address in the email field. If both fields are provided, only userId is used.

string

可选

User ID of the user to whom you would like to assign the role.

返回响应

🟢201**HTTP Status Code:** `201` Members Added

application/json

Body

add_at

string <date-time>

可选

Date and time at which the members are assigned to the role.

ids

string

User ID

可选

🟠400**HTTP Status Code:** `400` **Error Code:** `1034` Role does not exist. **Error Code:** `300` RoleId required. Can’t delete or add members for Normal/Owner roles.