# Queries / Roles

# Roles

**Query**
## permissions — Returns [[Permission]](/documentation/Objects/Permission#Permission)

<p class="scopes"><span class="scope scope--none">No scope required</span></p>

**Example Query**

```graphql
query GetPermissions {
    permissions {
        id,
        name,
        safeName,
        section
    }
}
```

**Query**
## role — Returns [Role](/documentation/Objects/Role#Role)

**Scopes required:** modify_roles_permissions

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the role to retrieve |

**Example Query**

```graphql
query GetRole($id: ID!) {
    role(id: $id) {
        id,
        name,
        managedId
    }
}

# Example variables
{
    "id": "<ID>"
}
```

**Query**
## roles — Returns [[Role]](/documentation/Objects/Role#Role)

**Scopes required:** modify_roles_permissions

**Example Query**

```graphql
query GetRoles {
    roles {
        id,
        name,
        managedId
    }
}
```