> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revise a policy

> Revise workspace policies.

Requires Policies enabled and an active workspace member with administrator access as the caller. Reads require `policies:read`; writes require `policies:write`.

REST access is not available yet. It depends on planned support for API keys associated with workspace members. These endpoints do not accept signed-in user tokens.

Creates or returns the draft revision of an active or paused policy. The current version remains in its existing state until the new draft is activated.

Use the `Idempotency-Key` header for an identical write retry. Through MCP, use `idempotency_key` in the tool arguments.

### Agent proposals

The agent can discover these capabilities through its catalog. Write proposals require `policies:request` and Read. Request tools return an unapplied Changeset; a permitted person must authorize application. Policy activation is an explicit proposal separate from draft creation.

### Returns

Returns the resulting policy and its lifecycle state.