orvanta runs
Manage workflow run history and inspect execution details.
orvanta runs <subcommand> [options]Subcommands
Section titled “Subcommands”trigger
Section titled “trigger”Trigger a new run of a workflow.
orvanta runs trigger [options]| Flag | Description |
|---|---|
--workflow <id-or-name> | Workflow to run. Required. |
--input <key=value> | Pass input context values. Repeatable. |
--wait | Wait for the run to complete before returning. |
--json | Output run details as JSON. |
Example:
orvanta runs trigger --workflow data-ingestion --input env=production --waitList recent runs.
orvanta runs list [options]| Flag | Description |
|---|---|
--workflow <id-or-name> | Filter by workflow. |
--status <status> | Filter by status (queued, running, succeeded, failed, cancelled, awaiting_approval). |
--limit <n> | Maximum results (default: 20). |
--json | Output as JSON. |
Stream or fetch logs for a run.
orvanta runs logs <run-id> [--follow]| Flag | Description |
|---|---|
--follow | Stream live log output (for running runs). |
--node <node-id> | Filter logs to a specific node. |
context
Section titled “context”Show the context snapshot at the end of a run.
orvanta runs context <run-id>cancel
Section titled “cancel”Cancel a queued or running run.
orvanta runs cancel <run-id> [--reason <text>]approve
Section titled “approve”Approve a run that is awaiting ConsentGate sign-off.
orvanta runs approve <run-id> [--reason <text>]reject
Section titled “reject”Reject a run that is awaiting ConsentGate sign-off.
orvanta runs reject <run-id> [--reason <text>]