> For the complete documentation index, see [llms.txt](https://docs.codemash.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codemash.io/cloud/membership/roles/edit.md).

# Edit a role

**Where:** Membership → Roles → role → Edit · `/projects/<project>/membership/roles/<roleName>/edit`

{% hint style="info" %}
Screenshot TODO — capture comes from testing-plan area **16-membership**.
{% endhint %}

The same form as [Add New Custom Role](/cloud/membership/roles/new.md), loaded with the saved values — the screen title reads **Editing role**. The **Role name** field is locked; you can change the **Description** and the **Attached policies**. Saving applies the new policy set to every user who has the role.

System (built-in) roles open as **Displaying system role**: name, description, and attached policies are shown read-only, and both **Save** and **Delete** are unavailable. Custom roles can be deleted from the actions menu (⋯ → Delete).

## Use it from code

[Membership → Roles](/sdks-and-cli/membership/roles.md)

## API reference

Endpoints: [Membership → Roles](/api-reference/membership/roles.md).