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
| Flag | Meaning |
|---|---|
--reason <why> | Why the request is withdrawn (mandatory). |
Exit codes
| Code | Meaning |
|---|---|
| 0 | Withdrawn. |
| 1 | Refused — not the requester, not a change record's request, the quorum completed, or the checklist is already finalised. |
| 2 | Usage error, including a missing --reason or server target. |