opschain governance references
Included from Basic tier
opschain governance references (--run <id> | --external-id <id> [--system <system>]) [--limit <n>]
Reads the external references steps reported
(GovernanceService.ListExternalReferences). --external-id is the
auditor's lookup: starting from an entry in a target system's own audit
log — an ARM operation, a Cloudflare audit entry, a commit, an issue key —
it finds the OpsChain steps that reported that id, with their run, node,
chain and principal id. --run lists every reference one run's steps
reported. -o json / -o yaml emit the references (opschain docs resources/governed_activity).
A run you cannot read answers not found; in an --external-id lookup a
step on a node you cannot read never appears.
Flags
| Flag | Meaning |
|---|---|
--run <id> | Every reference this run's steps reported. |
--external-id <id> | The id a target system minted: every step that reported it. |
--system <system> | Narrow --external-id to one target system, e.g. azure. |
--limit <n> | At most this many references (default 100). |
Name exactly one of --run and --external-id.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Listed (possibly none). |
| 1 | The server refused or is unreachable; the run is not readable. |
| 2 | Usage error — neither or both of --run and --external-id, --system with --run, a non-positive --limit. |
Examples
opschain governance references --external-id 8f2c41d0 --system cloudflare
SYSTEM KIND ID RUN STEP NODE RECORDED
cloudflare rule 8f2c41d0 019a…-7c21 edge_apply /projects/hosted_ops/environments/prod 2026-11-17T22:31:09Z