POST/rooms/:name/update-permissions
Updates permissions for participants in an ongoing meeting.
In the case of an error, returns an HTTP error with information about the error in the response body.
See the documentation for the in-call updateParticipant method for more details about participant permissions.
Path params
The name of the room.
Body params
Each key-value pair in the data object defines a set of permission updates to apply to a given participant. To specify a specific participant, use the participant id as the key in the data object, with the value being the object described below. You can also apply an update to all participants except those specified explicitly by using the key "*" instead of a participant id.
The value of each pair is an object containing some or all of the following properties:
| Attribute Name | Type | Description | Example |
|---|---|---|---|
hasPresence | boolean | Determines whether the participant is "present" or "hidden" | false |
canSend | boolean or array | Array of strings identifying which types of media the participant can send or a boolean to grant/revoke permissions for all media types. | ['video', 'audio'] |
canAdmin | boolean or array | Array of strings identifying which types of admin tasks the participant can do or a boolean to grant/revoke permissions for all types. | ['participants'] |
Each provided permission — hasPresence, canSend, or canAdmin — overwrites whatever value the participant previously had for that permission. If you omit one of these fields, the corresponding participant permission won't be changed.
See the documentation for the in-call updateParticipant method for the allowed values for types of canSend and canAdmin permissions.