Skip to main content
Version: v5.7.0

opschain approvals list

packs:change-governance

opschain approvals list [flags]

Lists the open approval checklists on targets you may read (ChangeGovernanceService.ListPendingApprovals), oldest first — the approvals inbox. The table is RUN KIND TARGET ACTION STATUS REQUESTED BY WHY WAITING ON YOU; WHY is the first line of the requester's stated rationale (cut to the column; - when none was stated or the context is not served to you), and WAITING ON YOU marks checklists with an unsatisfied line you may approve. opschain approvals show <run-id> prints the whole approval context — rationale, agent and tier, recommendation, chain.

-o json / -o yaml emit the typed checklists (lines, approval rows, clocks, fingerprints, context) under checklists.

The inbox is the open set only. Past decisions — what you approved, rejected or break-glassed, and for the governance administrator everyone's — are opschain approvals history (opschain docs cli/approvals-history).

Flags​

FlagMeaning
--filter <column>[!]=<value>Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces fold to _); * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Grammar: opschain docs cli.

Exit codes​

CodeMeaning
0Listed (an empty selection prints no open approval checklists).
1The read failed — the error names the server's Connect code and message.
2Usage error, including a missing server target.