---
title: "Roles"
slug: "roles-api"
updated: 2025-10-16T08:41:19Z
published: 2025-10-16T08:41:19Z
canonical: "developer.rocket.chat/roles-api"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

> [!NOTE]
> Refer to the [Roles user guide](https://docs.rocket.chat/docs/roles-in-rocketchat) 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](https://docs.rocket.chat/docs/roles-in-rocketchat) 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](/v1-api/apidocs/get-roles) endpoint to view the list of roles with their IDs in your workspace.