Revise a policy
Policies
Revise a policy
Revise workspace policies.
POST
Revise a policy
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 requirepolicies: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.