Update policy status

Change the lifecycle status of a policy. Status changes may require approval depending on organization settings.

Path Parameters

ParameterTypeRequiredDescription
idstring (UUID)YesPolicy UUID to update

Request Body

FieldTypeRequiredDescription
statusstringYesNew policy status

Policy Statuses

StatusDescription
DRAFTUnder development, not enforced
PENDING_APPROVALSubmitted for approval, awaiting votes
ACTIVECurrently enforced on matching transactions
INACTIVEDisabled but preserved (can be reactivated)
ARCHIVEDHistorical record only, cannot be reactivated

Valid Status Transitions

  • DRAFT → PENDING_APPROVAL (submit for approval)
  • PENDING_APPROVAL → DRAFT (revert to draft)
  • PENDING_APPROVAL → ACTIVE (when approval quorum met)
  • ACTIVE → INACTIVE (disable policy)
  • INACTIVE → ACTIVE (reactivate policy)
  • ACTIVE / INACTIVE → ARCHIVED (archive policy)

Required Permission

policies:edit