Get a workflow run
Returns a single run — live state for in-progress runs, or the full history for completed runs.
Requires: workflows:invoke
Authorizations
A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.
Path Parameters
Numeric workflow id.
42
Run identifier.
"wf_42_run_1"
Query Parameters
Response
Composite run identifier (workflowId:temporalRunId).
"wf_42_run_1:11111111-2222-3333-4444-555555555555"
Workflow run identifier.
"wf_42_run_1"
Parent workflow id.
42
Snapshot of the workflow name at the time the run was indexed.
"Daily Sales Report"
Workflow type.
task, workflow "task"
Run status (running / awaiting_human / completed / error / cancelled).
"completed"
Where the payload was read from. live-query = the run is still in progress; history = a completed run.
live-query, history Run identifier; a workflow may have multiple runs after a retry.
Trigger type for the run (schedule / webhook / api / slack / manual).
ISO-8601 start timestamp.
ISO-8601 end timestamp; absent for in-flight runs.
Duration in milliseconds (when end timestamp is known).
Short human-readable summary of the run outcome.
Pending approval payload (only present when status is awaiting_human).
Display-only signal that the workflow closed for a non-success reason.
approval_timeout Final result of a task-typed workflow run. Free-form (depends on the workflow).
Error message for a failed task-typed workflow run.
Per-node state for a workflow-typed workflow run.
Set when history was unavailable; source will be live-query in that case.