Workflow Runs

Get Workflow Run Detail

Available for: Chatflow, Workflow apps.

Get a single workflow run's status, inputs, outputs, and execution metrics.

get/workflows/run/{workflow_run_id}

Path parameters

workflow_run_idstring required

Workflow run ID, from the response or streaming events of Run Workflow, or from message metadata in Chatflow apps.

Response

Successfully retrieved workflow run details.

idstring uuid

Workflow run ID.

workflow_idstring uuid

Workflow ID.

statusstring

Workflow execution status. running for in-progress executions, succeeded when completed successfully, failed when execution encountered an error, stopped when manually halted, partial-succeeded when some nodes succeeded but others failed, paused when awaiting human input.

inputsstring nullable

Input variables of the workflow run, returned as a raw JSON string that clients must parse (e.g., {"query": "..."}). May be null.

outputsobject

Output data from the workflow. An empty object until outputs are available.

errorstring nullable

Error message if the workflow failed.

total_stepsinteger

Total number of workflow steps executed.

total_tokensinteger

Total tokens consumed.

created_atinteger

Unix timestamp of when the workflow run was created.

finished_atinteger nullable

Unix timestamp of when the workflow run finished.

elapsed_timenumber float nullable

Total time elapsed in seconds.

Changes

No recorded changes to this endpoint across all 10 revisions of this API.