Create new policy version

Create a new version of an existing policy. The new version may require approval before taking effect, depending on organization configuration.

Path Parameters

ParameterTypeRequiredDescription
idUUIDYesCurrent policy version identifier

Request Body

No request body. The endpoint creates a new DRAFT version by copying all data from the specified policy and incrementing the version number. Use PATCH on the new version to make changes.

Use Cases

  • Update policy with new rules
  • Create new version for approval workflow
  • Evolve policy over time with full history

Required Permission

policies:create or policies:update