Skip to main content
Version: v5.7.0

opschain admin queue list

Included from Basic tier

The per-entry dispatch-plane listing with each entry's owning work item: a call to the API v2 FleetQueueService.ListQueueEntries procedure, rendering every entry the scheduler currently carries — parked ready or held by a live lease — with the owner's kind (change, workflow_run or node_background_task), the owner's current status, the target node path, the correlation chain id where one exists, the dispatch state and the placement-verdict reason. This is how a stuck queued entry that is invisible in the activities feed (a node background task, e.g. a Regenerate Actions request) reads as what it is instead of a bare run id.

An entry whose run id matches no owning row renders - in the owner columns; one whose OWNER column shows a finalised status is an orphan — clear it with opschain docs cli/admin-queue-sweep.

Flags​

FlagMeaning
--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, then the token stored by opschain admin login).

Admin-token gated like opschain admin queue: the bearer must carry the /admin updatable grant. -o json|yaml prints the typed entries in their wire shape.

Exit codes​

CodeMeaning
0Entries listed.
1Request failed or the token was refused.
2Usage error — missing server or token.

Examples​

opschain admin queue list --server https://ops.example.com
RUN       OWNER                 STATUS        TARGET                     CHAIN     STATE   REASON
01a1f3c2  node_background_task  initializing  /projects/demo/assets/web  -         parked  no live runner satisfies the placement requirement
01a1f4d9  change                queued        /projects/demo/envs/prod   01a1f4d9  leased  -

See also​

  • opschain docs cli/admin-queue — the aggregate depth/lease view.
  • opschain docs cli/admin-queue-terminate — terminate an entry through its owner's cancel lane.
  • opschain docs cli/admin-queue-sweep — clear orphaned entries.
  • opschain docs fleet-queue — the entry fields and the verdict ladder.