opschain admin changes active
Included from Basic tier
Lists the in-flight changes across every replica — the admin-gated v2
SystemService.ListActiveChanges read. Each row carries the change's id, status,
action, target node path, who created it and when (the raw document adds the
project path and start time). It is the operator's counterpart to a user's
own run listing: one view of everything currently executing, before deciding
to quiesce, halt or just wait.
Flags
| Flag | Meaning |
|---|---|
--server <url> | Server base URL (default: the active context / OPSCHAIN_SERVER). |
--auth-token <token> | Admin bearer token override (default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN). |
--filter <column>[!]=<value> | Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces/dashes fold to _); * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side. Grammar: opschain docs cli. |
Like every admin verb, this command rides your opschain login session by
default, with the admin-token lanes as the automation fallback.
-o json|yaml prints the raw document, including the fields the table omits.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Listing fetched (including an empty one). |
| 1 | Request failed, non-200 response, or the token was rejected. |
| 2 | Usage error — missing server or token. |
Named errors
this command needs a login or an admin token — run 'opschain login', pass --auth-token, set OPSCHAIN_ADMIN_TOKEN, or store one with 'opschain admin login'— exit 2.the server rejected the credential — run 'opschain login' again, or check the admin token— HTTP 401 (exit 1).the server answered <code>: <message>— any other refusal (exit 1).
Examples
opschain admin changes active --server https://ops.example.com
ID STATUS ACTION TARGET CREATED BY CREATED
01999a7e running web:deploy demo/environments/dev/assets/web alice 2026-10-14T02:58:41Z
With nothing in flight the command prints no active changes and still
exits 0.
See also
opschain docs cli/admin-queue— whether those changes' steps are leased or still waiting.opschain docs cli/admin-platform-halt— the emergency stop for what this lists.