> ## 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.

# List policies

> List 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.

Supports `limit`, `cursor`, `starting_after`, `ending_before`, and `count`. The default limit is 10, with a maximum of 100. Count mode returns only `total` and cannot be combined with pagination.

Filter by `subject` and `status` (`draft`, `active`, `paused`, or `superseded`).

### 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 a page with `data` and an optional `cursor`, or `total` in count mode.