opschain runs continue
Included from Basic tier
opschain runs continue <run-id> --step <step-id> [--message <text>] [--input <name=value>]...
Continues one waiting step of a server run — releases a plain wait step so
the run proceeds. The run id picks the step family — a change's steps or a
workflow run's workflow steps, with the same fall-through as runs show —
and --step names the step; the answer posts the step's continue verb on
API v2 (StepService.ContinueStep, or
WorkflowStepService.ContinueWorkflowStep for a workflow run's step).
Find the waiting step's id in runs show <run-id> -o json: it is the step
whose status_code is waiting. A step that is not waiting for this
answer is refused by the server with its named error. Every answer is
audited.
This is a server verb. A local attached run's gates are answered on the terminal prompt instead (or pre-answered by the create command's auto-approve flag).
Flags
| Flag | Meaning |
|---|---|
--step <step-id> | The waiting step's id (required). |
--message <text> | Audit note recorded with the answer. |
--input <name=value> | Wait-step input argument (repeatable; values parse as JSON when valid). Merged over the step's declared defaults and recorded on the step. |
Output
continued step 0199c8aa-… of run 0199c81e-… — now running
-o json|yaml prints the answered step document; the step's new status is
its status_code.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Answered. |
| 1 | The answer failed — unknown run, or the server refused it (step not waiting to be continued). |
| 2 | Usage error (missing --step, local target). |
Named errors
runs continue answers a server run's gates — pass --server <url> or 'opschain context use <name>' (local runs prompt on the terminal instead)— no server target (exit 2).required flag(s) "step" not set— exit 2.run "<id>" not found on the server— neither family knows the id (exit 1).
See also
opschain docs cli/runs-approveandopschain docs cli/runs-reject— the other two answers.opschain docs cli/runs-show— find the waiting step.opschain learn 3.1andopschain learn 4.1— gates in the walkthroughs.