Skip to main content
Version: v5.6.1

opschain approval-policies update

packs:change-governance

opschain approval-policies update <policy-id> [flags]

Updates an approval policy (ChangeGovernanceService.UpdateApprovalPolicy): only the flags you pass change; --action-pattern, --where and the approver flags replace their stored sets wholesale. Needs the delegable change-governance determination and a stepped-up session.

Flags​

FlagMeaning
--name <name>Rename the policy.
--path-pattern <glob>Replace the node-path glob the policy covers.
--action-pattern <glob>Replace the action-name globs with the given set (repeatable).
--clear-action-patternsCover every action again.
--where <predicate>Replace the metadata predicates with the given set (repeatable; same grammar as create).
--clear-whereDrop every metadata predicate.
--approver-user <name>A username on the replacement approver list (repeatable).
--approver-group <name>A directory group on the replacement approver list (repeatable).
--approver-kind <kind>A resolved approver kind on the replacement list (repeatable).
--quorum <n>Distinct approvals required.
--self-approvalLet the requester's or change owner's approval count.
--strictNever subsumed, and refuse covered creates on entitlement lapse.
--require-windowRelease covered subjects only inside an open admitting maintenance window.
--require-step-upDemand an elevated session on a matched create.
--require-change-referenceDemand a typed external change reference before approval.
--quorum-ttl <duration>How long gathered approvals may wait for quorum.
--approval-validity <duration>How long a completed approval stays valid.
--enabledEnable or disable the policy (--enabled=false disables).

Exit codes​

CodeMeaning
0Done.
1The server refused or failed the request (named in the error).
2Usage error — missing mandatory flags or no server target.