> 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/policies/edit.md).

# Edit a policy

**Where:** Membership → Policies → policy → Edit · `/projects/<project>/membership/policies/<policyName>/edit`

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

The same JSON editor as [Add New Custom Policy](/cloud/membership/policies/new.md), loaded with the saved document — the screen title reads **Editing policy**. The document now carries a `pid` field with the policy's public id (`pol_…`); leave it in place so the update validates. Saving applies the changed permissions immediately to every role — and through the roles, every user — holding the policy.

System policies open as **Displaying system policy**: the document is read-only and cannot be saved or deleted. Custom policies can be deleted from the actions menu (⋯ → Delete).

## Use it from code

[Membership → Policies](/sdks-and-cli/membership/policies.md)

## API reference

Endpoints: [Membership → Policies](/api-reference/membership/policies.md).