---
title: "Get Permissions (Realtime)"
slug: "get-permissions-realtime"
updated: 2024-12-04T10:36:03Z
published: 2024-12-04T10:36:03Z
---

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

# Get Permissions (Realtime)

List all the [permissions](https://docs.rocket.chat/v1/docs/permissions) in this workspace. Each permission is associated with a [role](https://docs.rocket.chat/v1/docs/roles-in-rocketchat). You can use this information to customize your UI based on user permissions.

| Method | Requires Auth |
| --- | --- |
| `permissions/get` | Yes |

## Example call

```json
{
    "msg": "method",
    "method": "permissions/get",
    "id": "423",
    "params": [
        {
            "_id": "8gMsLe9A7pZjo2D2iB",
            "rid": "64a1f373376181965ab77f54",
            "msg": "Hello World!"
        }
    ]
}
```

## Example response

```json
{
    "msg": "result",
    "id": "442",
    "result": [
        {
            "_id": "access-permissions",
            "_updatedAt": {
                "$date": 1688334885629
            },
            "roles": [
                "admin"
            ]
        },
        {
            "_id": "access-setting-permissions",
            "_updatedAt": {
                "$date": 1688334885660
            },
            "roles": [
                "admin"
            ]
        },
        {
            "_id": "add-oauth-service",
            "_updatedAt": {
                "$date": 1688334885667
            },
            "roles": [
                "admin"
            ]
        },
        {
            "_id": "add-user-to-joined-room",
            "_updatedAt": {
                "$date": 1688334885673
            },
            "roles": [
                "admin",
                "owner",
                "moderator"
            ]
        },
        {
            "_id": "add-user-to-any-c-room",
            "_updatedAt": {
                "$date": 1688334885682
            },
            "roles": [
                "admin"
            ]
        }
    }
      
```

## The permission object

The permission object describes permission as:

- `_id`: The permission's ID.
- `roles`: A collection of roles that this permission applies to.
- `_updatedAt`: (Optional) The last time this permission object was updated in the database.
- `meta`: Metadata about the permission.
- `$loki`: An internal property that can be ignored (it is removed on the web client before being added to the web client's database).