# User Roles

User roles are essential for managing access within our system. They define each user's responsibilities and privileges, ensuring a secure and well-organized environment.

### Accessing User Roles in the Admin Console

To view and manage user roles:

1. Navigate to the Admin Console.
2. Click on **Groups & Permissions** in the left-hand menu.
3. Select the **User Roles** tab.

### Searching for User Roles

To find specific user roles:

1. On the **User Roles** page, view the roles displayed as cards, with each card representing a specific user role.
2. Use the **Search** box located above the role cards.
3. Enter a relevant keyword related to the user role you're looking for.
4. Click the **Search** button to display matching results.

<figure><img src="/files/tF15w6WZnANsZxmNirO0" alt=""><figcaption></figcaption></figure>

### Create New Roles&#x20;

1. To create a new user role:
   1. Click the **Create New Role** button.
   2. Fill in the required details as described below.

<figure><img src="/files/6dJyJxLoUjDJmQZv2Uzc" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">User Role Details</mark>&#x20;

To create a new user role:

1. ***Key:*** A unique identifier for each user role. Think of it as a distinctive code that differentiates one role from another within the system.
2. ***Name:*** A user-friendly label for the role. This is how users will easily identify the purpose of the role at a glance.
3. ***Description:*** An optional field to provide additional context about the role. Use this to describe its responsibilities and purpose, similar to a job description.

<figure><img src="/files/MX4QkdRMg5lWCAjjhce8" alt=""><figcaption></figcaption></figure>

4. Saving the New User Role

After filling in the mandatory fields:

* Review the entered details to ensure accuracy.&#x20;
* Click the **Save** button to create the new role.

#### Editing User Roles&#x20;

1. On the User Roles page, locate the role you want to edit.
2. Locate the role you want to edit and click the **Edit** icon.

<figure><img src="/files/KNJov68GLYMSovx8oCd4" alt=""><figcaption></figcaption></figure>

3. This will open the **Edit Role** page, where you can modify the following details:
   * **Key**: Update the unique identifier if needed.
   * **Name**: Change the user-friendly label for the role.
   * **Description**: Adjust or add more context about the role's purpose and responsibilities.

<figure><img src="/files/Np8YOW2EZMziEbC8r3y0" alt=""><figcaption></figcaption></figure>

4. Ensure all mandatory fields are completed.
5. Click the **Save** button to apply the changes.

### Delete User Role&#x20;

To delete an existing user role:

1. Open the **Edit Role** page for the role you wish to delete.
2. Locate and click the **Delete** button.
3. A confirmation prompt will appear—review the details carefully.
4. Confirm your decision to permanently delete the role.

<figure><img src="/files/cAb3fuBDQYBVeeWeCXXa" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://authdocs.skill-mine.com/licentio-documentation/groups-and-permissions/user-roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.