Permissions

Prev Next

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.