opschain triggers firings
triggers
opschain triggers firings <project>/<code> [--status <s>] [--deferred]
[--since <duration>] [--wide] [--reverse]
Lists a trigger's firings — the settled outcome of each time the trigger matched an event — newest first. Each firing's status is one of:
| Status | Meaning |
|---|---|
created | The firing made something — the CREATED column names it as <type>/<id>. |
suppressed | Matched but intentionally not acted on (throttled, or discarded by an operator) — the ERROR column carries the reason. |
failed | The action could not be created — the ERROR column carries the failure. |
deferred | Parked by a maintenance window, not settled yet: it releases when the window ends unless discarded first. |
Table columns: WHEN, STATUS, EXECUTED-AS (the run-as identity, -
when none), CREATED and ERROR. Ids and errors are truncated for the
table; --wide shows the untruncated error column and full created ids.
-o json|yaml prints the filtered firing documents instead. An empty
result prints no matching firings.
Filters combine: --status keeps one status, --deferred is shorthand for
--status deferred (the two conflict unless they agree), and --since
keeps only firings newer than the given duration ago. Both filters are
applied server-side (the filter[status] / filter[since] query
parameters), so a filtered page never silently loses older matches to the
listing cap. --reverse prints oldest first (latest at the bottom),
applied after filtering.
Needs a server target (--server <url>, OPSCHAIN_SERVER, or the active
context).
Flags
| Flag | Meaning |
|---|---|
--status <s> | Only firings with this status: created, suppressed, failed or deferred. |
--deferred | Only deferred firings — the work parked under maintenance windows; the ERROR column carries each deferral's reason. |
--since <duration> | Only firings newer than this duration ago (e.g. 1h, 30m). |
--wide | Untruncated error column and full created ids. |
--reverse | Print oldest first (latest at the bottom). |
--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; --status and --since narrow server-side. Grammar: opschain docs cli. |
Exit codes
| Code | Meaning |
|---|---|
| 0 | Listing printed (an empty listing is still success). |
| 1 | The command failed (trigger not found, server error). |
| 2 | Usage error — invalid filter, malformed address, no server target. |
Named errors
invalid --status "<s>" (must be created, suppressed, failed or deferred)— exit 2.--deferred conflicts with --status "<s>"— exit 2.--since wants a duration like 1h or 30m: <parse error>— exit 2.trigger "<code>" not found in project "<project>"— exit 1.
Examples
opschain triggers firings demo/promote_on_success --since 24h
opschain triggers firings demo/promote_on_success --status failed --wide
opschain triggers firings demo/promote_on_success --deferred
See also
opschain docs cli/triggers-discard— prune one deferred firing before its window releases.opschain docs cli/triggers-show— the definition plus the ten newest firings.opschain learn 5.6(maintenance windows).