> For the complete documentation index, see [llms.txt](https://docs.bluefletch.com/bluefletch-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/roles/manage-roles.md).

# Manage Roles

## User Guide: Admin Tab <a href="#user-guide-admin-tab" id="user-guide-admin-tab"></a>

### Manage Roles <a href="#manage-roles" id="manage-roles"></a>

An administrative user with permission to manage roles (for example, a user with the [predefined](/bluefletch-enterprise/product-guides/portal/admin/roles/predefined-roles.md) "Admin" role) can create, edit, and delete custom roles or assign a role to one or more users from the [***Roles***](https://ems.bluefletch.com/admin/roles) subtab within the ***Admin*** section of the BlueFletch Portal.

<figure><img src="/files/w73150BvRCpE2VTjsXZf" alt="" width="563"><figcaption></figcaption></figure>

#### Create Roles <a href="#create-roles" id="create-roles"></a>

1. On the ***Roles*** page, press the **Create New Role** button in the upper right corner.
2. Enter content in the *Role Name* and *Description* fields. These fields are required.

<figure><img src="/files/ZhDh97fYfSjnmZEL7tC4" alt="" width="563"><figcaption></figcaption></figure>

3. Press **Select Permissions** button and check at least one permission from the list. A permission must be selected to create a role.\
   Consult the [***Permissions***](/bluefletch-enterprise/product-guides/portal/admin/roles/permissions.md) document to determine if there are any prequisites for a permission; an error will occur on login for a user who is assigned a role that is missing permissions.
4. Press **Select Users** button and select one or more users, if desired. Selecting a user is not required to create a role.

   > **Note:** A role can also be applied to a user when adding or editing one in the [***Users***](https://ems.bluefletch.com/admin/users) subtab within ***Admin***.
5. Press **Create** button to save the new role. The role will appear in the alphabetized list on the ***Roles*** page.

#### Edit and Delete Roles <a href="#edit-and-delete-roles" id="edit-and-delete-roles"></a>

1. On the ***Roles*** page, select a role from the list on the left and select **Edit Role** or **Delete Role** from the three-dot option menu.
2. If choosing to delete, an alert box will display prompting confirmation. Only roles created by the organization may be deleted. Predefined roles cannot be deleted.

<figure><img src="/files/pTQ2a5Pk9S9stFD5ylBg" alt="" width="563"><figcaption></figcaption></figure>

3. If choosing to edit, the screen will proceed to ***Edit Role*** page. Make any changes (as allowed, depending on the role) to the role and press **Update** button to save changes.


---

# 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://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/roles/manage-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.