> For the complete documentation index, see [llms.txt](https://securitybot.gitbook.io/securitybot-knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://securitybot.gitbook.io/securitybot-knowledge-hub/command-reference/roles.md).

# /roles

{% hint style="success" %}
**Available on all tiers**
{% endhint %}

Configure which Discord roles map to SecurityBot's Administrator, Moderator, and Exempt permission tiers. Use `/roles view` to see the current configuration, or assign roles with the other subcommands.

The exempt list supports multiple roles. Add or remove roles individually with `/roles exempt add` and `/roles exempt remove`, or manage the full list from the web dashboard.

***

## Usage

| Subcommand      | Options                 | Description                                                |
| --------------- | ----------------------- | ---------------------------------------------------------- |
| `view`          | None                    | Shows current role configuration (admin, mod, exempt list) |
| `administrator` | `role` (Role, required) | Sets the SecurityBot administrator role                    |
| `moderator`     | `role` (Role, required) | Sets the SecurityBot moderator role                        |
| `exempt add`    | `role` (Role, required) | Adds a role to the exempt list (bypasses filters)          |
| `exempt remove` | `role` (Role, required) | Removes a role from the exempt list                        |

### Example

```
/roles administrator role: @Staff
```

```
/roles exempt add role: @Mods
/roles exempt add role: @Partners
/roles view
```

```
/roles exempt remove role: @Partners
```

***

## Validation

* You cannot **assign** managed roles (bot roles or integration roles) to administrator, moderator, or the exempt list.
* For `administrator` and `moderator`, the bot must be higher in the role hierarchy than the role being assigned. The exempt list has no hierarchy requirement -- you can exempt roles above the bot.

***

## Permissions

**Administrator** -- All subcommands require the SecurityBot admin role, Discord ADMINISTRATOR permission, or server ownership.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://securitybot.gitbook.io/securitybot-knowledge-hub/command-reference/roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.