---
title: "Permissions"
slug: "permissions-api"
updated: 2025-10-16T08:43:57Z
published: 2025-10-16T08:43:57Z
canonical: "developer.rocket.chat/permissions-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.

# Permissions

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.

> [!NOTE]
> For details on Rocket.Chat permissions and access control, refer to the [Permissions user guide](https://docs.rocket.chat/docs/permissions).

**Note on common parameters**:

- Roles have two common parameters, `name` and `_id`.
- The names 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.