Skip to main content
Version: v5.8.0

opschain approvals withdraw

packs:change-governance

opschain approvals withdraw <run-id> --reason <why>

Takes back a change record's pending approval request you raised (ChangeGovernanceService.WithdrawChecklist), with a mandatory reason. <run-id> is the request id opschain changes approve printed (the id approvals approve and approvals reject take). The checklist ends withdrawn, the record stays pending, and the next opschain changes approve raises a fresh request under the approval policy's current version:

withdrawn — <run-id> is withdrawn and change record CHG-2026-042 stays pending; opschain changes approve CHG-2026-042 raises a fresh request

A withdrawal is not a decision, so the self-approval exclusion does not apply: on an estate where you are the gate's only approver and self-approval is off, you can neither approve nor reject your own request, but you can always withdraw it — then fix the policy and request again (opschain changes approve replaces a request raised under an earlier policy version on its own; opschain docs cli/changes-approve).

Only the requester may withdraw, and only while the request is pending: an approver who is not the requester is refused, a request whose quorum completed or that is already finalised is refused by name. It needs update on the owner's change_records rule path (the right that raises a request), and an agent, a service account or a step's credential is refused by name. A held run's checklist is not withdrawn — cancel the run (opschain runs cancel).

The withdrawal is audited twice, like a rejection: audit:approvals:withdraw (the reason and the request id) and audit:change_record:approval_withdrawn on the record's ledger, written in the transaction that withdraws the checklist; both read under the approval kind of opschain changes show. opschain approvals history lists withdrawn requests when asked for the withdrawn outcome (opschain docs cli/approvals-history); its default lists decisions only.

Flags​

FlagMeaning
--reason <why>Why the request is withdrawn (mandatory).

Exit codes​

CodeMeaning
0Withdrawn.
1Refused — not the requester, not a change record's request, the quorum completed, or the checklist is already finalised.
2Usage error, including a missing --reason or server target.