Permissions are used to define and enforce granular access controls for Rocket.Chat features by enabling and disabling permissions for roles.
With Permissions API, you can:
Assign or restrict permissions for actions like messaging, file uploads, and administrative tasks.
Customize permission sets through API calls to align with security policies.
For details on Rocket.Chat permissions and access control, refer to the Permissions user guide.
Note on common parameters:
Roles have two common parameters,
name
and_id
.The names and ID are the same for default Rocket.Chat roles such as
admin
,user
,owner
, etc.For custom roles (Enterprise plans), role names and IDs are different. The role name is the custom role name that you have defined, and the role ID is a string of letters and numbers (for example,
679398c4f7ca7be1b5fcf5b7
).Use the Get Roles endpoint to view the list of roles with their IDs in your workspace.