Roles

Rocket.Chat's comprehensive role-based system allows administrators to assign roles, each with a specific set of permissions, to control user actions and access levels within the workspace. Using the Roles API endpoints, you can:

• Assign predefined or custom roles (e.g., Administrator, Moderator, Guest).

• Update roles to control access to features and settings.

• View roles and associated information.

Refer to the Roles user guide for details on this feature.

Note on common parameters:

• Roles have two common parameters, name and _id.

• The name 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.