Workflow Runs

Get Workflow Run Detail

Available for: Chatflow, Workflow apps.

Retrieve the current execution results of a workflow task based on the workflow execution ID.

get/workflows/run/{workflow_run_id}

Path parameters

workflow_run_idstring required

Workflow run ID, can be obtained from the workflow execution response, streaming events, or message metadata.

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