> For the complete documentation index, see [llms.txt](https://meetbit.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meetbit.gitbook.io/docs/access-and-permissions/roles.md). # Roles Roles are resource objects to which Permissions are attached. Users assigned to a specific Role automatically inherit the permissions associated with that Role. {% hint style="info" %} Permissions inherited from a User's Role are limited by the User's Department. {% endhint %}

## Viewing Roles {% hint style="warning" %} You must have permission to read Roles to perform the steps below. {% endhint %} 1. Visit the Roles Page at ; 2. If you want to search for a particular Role (or a group of Roles) based on their attributes, click the "Filter" button in the upper-left corner. 3. Click the "View" icon in the row of your chosen Role. You will now see the Role's details, its list of Permissions, and the activities associated with that specific Role. ## Creating Roles

{% hint style="warning" %} You must have permission to create Roles and be part of the Global Department to perform the steps below. {% endhint %} 1. Visit the Create Role Page at ; 2. Fill out the name of the Role. 3. Select the Permission/s you wish to assign to the User. 4. Click "Create". ## Updating Roles {% hint style="warning" %} You must have permission to edit Roles to perform the steps below. {% endhint %} 1. On the Roles Page, click the "Edit" icon in the row of your chosen Role. Alternatively, you can go to the Role's own page and click the "Edit" icon in the upper-right corner.

2. Update the settings you wish to change. 3. Click "Save Edits". 4. Confirm the action on the dialog popup. ## Deleting Roles {% hint style="warning" %} You must have permission to delete Roles to perform the steps below. {% endhint %} 1. On the Roles Page, click the "More" icon in the row of your chosen Role.

2. Click "Delete Role". Alternatively, you can go to the Role's own page and click the "Delete" icon in the upper-right corner. 3. Confirm the action on the dialog popup. {% hint style="danger" %} Deleting Roles is irreversible. Users associated with a deleted Role will immediately lose all permissions inherited from that role. {% endhint %} --- # 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://meetbit.gitbook.io/docs/access-and-permissions/roles.md?ask=&goal= ``` `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.