> For the complete documentation index, see [llms.txt](https://docs.apica.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apica.io/admin/access-management/role-management/manage-roles.md).

# Manage Roles

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

**Create Role**

1. Navigate to IAM > Roles
2. Click on Create role button
3. Enter the name of the role you want to create
4. Click on the Create button.

***

**View Roles**

1. Navigate to Settings > IAM > Roles.
2. From the list, click on the role you want to view.
3. This opens the Role Details page.
4. Use the left-hand menu to view associated Policies, Members, or Groups.

***

#### Assign Policy to a Role

1. Go to Settings > IAM > Roles.
2. Find the role you want to assign a policy to and click on Policies tab next to its name.
3. Click the Add Policy button in the left menu.
4. Select the policies to add and click OK to confirm.

***

#### Remove Policy from a Role

1. Navigate to Settings > IAM > Roles.
2. Locate the desired role and click on Policies tab next to it.
3. Find the policy you want to remove.
4. Click the Remove button next to that policy to remove the policy.<br>

***

#### Assign Members to a Role

1. Go to Settings > IAM > Roles.
2. Find the role you want to assign members to and click on Members tab next to the name.
3. Click the Add Member button in the left menu.
4. Select the members to add and click OK.<br>

***

#### Remove Members from a Role

1. Navigate to Settings > IAM > Roles.
2. Click on Members tab next to the desired role.
3. Locate the member you want to remove.
4. Click the Remove button next to their name.<br>

***

#### Assign Groups to a Role

1. Go to Settings > IAM > Roles.
2. Find the role and click on Groups tab.
3. Click the Add Group button in the left menu.
4. Select the groups to add and click OK.<br>

***

#### Remove Groups from a Role

1. Navigate to Settings > IAM > Roles.
2. Click on Groups tab next to the role.
3. Find the group you want to remove.
4. Click the Remove button next to it.<br>

***

#### Delete an Existing Role

1. Go to Settings > IAM > Roles.
2. Find the role you want to delete.
3. Click the Delete icon next to the role to delete.

***


---

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

```
GET https://docs.apica.io/admin/access-management/role-management/manage-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.