# Guide to manage role and permissions

The **Roles management** feature allows you to create and manage custom sets of permissions to control the access levels of members within this specific Workspace. By defining roles, you can ensure that each user has only the permissions they need to perform their tasks.

**In this article, you will learn how to:**

* View and search for roles within the Workspace.
* Create a new role with specific permissions.
* Delete a role that is no longer in use.

***

#### **1. The Role management page overview** <a href="#id-1.-the-role-management-page-overview" id="id-1.-the-role-management-page-overview"></a>

When you navigate to **Access management > Roles & permissions**, you will see a list of all roles that currently exist in the Workspace.

Each role in the list displays the following information:

* **Role name:** The identifier for the role.
* **Description:** A brief summary of the role's purpose.
* **Members:** The number of members currently assigned this role.
* **Features:** The number of permissions included in the role.
* **Last modified:** The date the role was last updated.
* **Action:** Available actions, such as deleting the role.

To quickly find a specific role, use the **Search role** bar at the top of the list.

***

#### **2. How to create a new Role** <a href="#id-2.-how-to-create-a-new-role" id="id-2.-how-to-create-a-new-role"></a>

Create custom roles to grant access to specific features within the Workspace.

**Steps:**

1. On the Roles Management page, click the **+ Create role** button.
2. A **Create new role** window will appear. Here, you will select the apps and features (permissions) for the new role.
3. Choose the application you want to grant permissions for, in this case, **Oten Workspace**.
4. Next, you will see a list of feature categories such as `Activity Log`, `Group Management`, `Role Management`, etc.
5. Click on a category to expand it and view the detailed permissions within. Check the box next to each permission you want to add to this role.
6. You must select at least one feature to be able to create the role.
7. Once you have selected all the necessary permissions, click the **Create Role** button at the bottom of the window to finish.

***

#### **3. How to delete a Role** <a href="#id-3.-how-to-delete-a-role" id="id-3.-how-to-delete-a-role"></a>

You can remove roles that are no longer necessary or in use.

**Steps:**

1. From the role list, find the role you wish to delete.
2. Click the **trash can icon (🗑️)** in the **Action** column corresponding to that role.
3. A confirmation dialog will appear to ensure you are certain. Confirm the action to permanently delete the role.

**Important note:** You typically cannot delete a role if it is still assigned to any members. You will need to unassign the role from all members before you can perform the deletion.


---

# 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://oten.gitbook.io/identity-support/user-guide/oten-workspace/guide-to-manage-role-and-permissions.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.