---
title: Roles
slug: roles
docTags: 
createdAt: 2026-04-29T13:59:52.411Z
---

A role is a collection of permissions used as a building block for access policies. Administrators can create custom roles; Bridge platform roles are system-managed.

# Accessing the roles page

From the Kyndryl Bridge main menu :inlineImage[]{src="https://api.archbee.com/api/optimize/QU1TIK52ntw5Jsos0uOt5/NK7Yw9tQgnlqBGwu7eG4H-20260601-205917.svg" alt caption width="28" height="28"}, go to **Administration** → Bridge Access Management → **Roles**

- Total roles, Bridge roles (Platform), Custom roles and planned Service roles.
- Custom roles list at the top; Platform roles at the bottom.
- Select the permissions count to view or search a role’s permissions.

# Viewing a list of roles

By accessing the **Roles** page, you are presented with four different cards providing relevant information for the Account Administrator:

- The **Total Roles** card displays the total number of roles in your account.
- The **Bridge Roles** card displays the total number of Platform roles in your account.
- The **Service Roles **card displays the total number of Kyndryl Bridge service roles in your account.
- The **Custom Roles **card displays the total number of custom roles created by the administrator.

# Creating a custom role

To create a custom role, complete the following steps:

1. From the **Roles** page, select **Add role.**
2. Enter role name and custom ID (both mandatory).
3. Enter an optional description.
4. Select a **Service** (non-editable after save).
   - Whenever a Kyndryl Bridge service is registered to Kyndryl Platform Central, it appears in this drop-down.
5. **Select a Role** for the chosen service. Platform roles are listed first, then custom roles.
   - This selection populates the permissions list for that service and role combination.
6. Review the populated permissions and **select the specific permissions** to include for this custom role.
7. Click **Save**.

# Editing a role

:::hint{type="info"}
You can edit only the custom roles that you have created. If the role name is not clickable, you might not have the required permissions to edit that role.
:::

To edit a custom role, follow these steps:

1. From the **Roles** page, locate the role that you want to edit.
2. Click the **overflow** menu :inlineImage[]{src="https://api.archbee.com/api/optimize/QU1TIK52ntw5Jsos0uOt5/JndGM9EedPv0uB0o6JMpp-20260601-221027.svg" alt caption width="28" height="28"}and select **View Details**.
3. Click **Edit** at the bottom of the page.
4. On the **Edit Role** page, you can modify the following details:

- **Role Name**: Enter a unique name to identify the custom role.
- **Description: **Provide a brief description of the role and its intended purpose.
- **Permissions:** Select the permissions that determine the actions users assigned to this role can perform. To modify role permissions,** select **or **clear** **the checkbox **next to the appropriate permission. 

5. Select **Update **and confirm the changes.

# Deleting a role

To delete a custom role, follow these steps:

1. Click the overflow menu next to the role of your choice and select **Delete**.
2. Confirm the deletion by typing the name of the role in the search field.

## Prerequisites for editing roles

To modify or remove roles, be aware of the following requirements:

- Editing preserves existing permissions. Custom ID and Service fields are not editable.
- Bridge Platform roles cannot be modified.
- Only custom roles can be deleted.

The authorized roles to perform these changes are:

- **Administrator**: Create, edit, delete custom roles.
- **Operator, contributor, viewer:** View roles.

# Learn more

[Roles and permissions](docId\:ICs69b2oEsEwnrtSMBI3W)