# How to Manage Roles & Permissions Section: Public API. Updated 2026-08-26. Page: https://help.fansmetric.com/public-api/how-to-manage-roles-permissions Roles define which Public API endpoints a key is allowed to use. By assigning roles to your keys, you make sure each integration only has the access it needs. ### Before You Begin > [!NOTE] > **Permission required:** You must be an **organization admin** to create, edit, or delete roles. ### Accessing Roles & Permissions Go to **Public API** in the left navigation menu (under the **Organization** group) and click **Roles & Permissions**. Each role shows its name, an optional description, how many permissions it includes (for example, ***130 of 147 permissions***), and how many keys use it.  > [!NOTE] > **Note:** One role is marked ***Default***. The default role has access to every Public API endpoint and **cannot be deleted**. ### Creating a Role 1. Click ***"Create Role"*** 2. Enter a **Role name** and an optional **Role description** 3. Pick a **Color** for the role badge using the color picker 4. Under **Public API Permissions**, select the endpoints this role can call: - Use the **Search permissions...** box to find a specific permission - Click ***"Select All"*** or ***"Clear"*** to toggle everything at once - Within a category, click ***"Select All in Group ›"*** to toggle just that group  5\. Click ***"Create Role"*** > [!NOTE] > **Note:** A role must have **at least one permission** selected before you can save it. ### Editing a Role Click ***"Edit"*** next to a role, adjust its name, description, color, or permissions, then click ***"Update Role"***. ### Deleting a Role Click ***"Delete"*** next to a role, then confirm by clicking ***"Delete Role"***. A role **cannot** be deleted if: - It is the **default** role, or - It is still **assigned to one or more API keys** — revoke or reassign those keys first ### Assigning Roles to Keys You assign roles to a key when you create it, or later using ***"Edit roles"*** on the API Keys page. A key can have more than one role, and its access is the combined permissions of all its roles. ### API Reference Building an integration on top of the Public API? The docs cover endpoint references, request examples, and a live request playground: - [Introduction](https://api-docs.fansmetric.com/introduction) — What the Public API can do and how to get started - [Authentication](https://api-docs.fansmetric.com/auth) — How to authenticate your requests - [API Keys](https://api-docs.fansmetric.com/auth/api-keys) — Passing your API key in requests ### Related Articles - [How to Create and Manage API Keys](https://help.fansmetric.com/public-api/how-to-create-and-manage-api-keys) - [How to Use the Public API Dashboard](https://help.fansmetric.com/public-api/how-to-use-the-public-api-dashboard)