Dify Octri Demo
GET/workflows/run/{workflow_run_id}

Get Workflow Run Detail

Available for: Chatflow, Workflow apps.

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

1 parameter
workflow_run_idstringrequired
Workflow run ID, from the response or streaming events of [Run Workflow](/en/api-reference/workflow-runs/run-workflow), or from message metadata in Chatflow apps.

3 status codes
200Successfully retrieved workflow run details.
created_atintegeroptional
Unix timestamp of when the workflow run was created.
elapsed_timenumberoptional
Total time elapsed in seconds.
errorstringoptional
Error message if the workflow failed.
finished_atintegeroptional
Unix timestamp of when the workflow run finished.
idstringoptional
Workflow run ID.
inputsstringoptional
Input variables of the workflow run, returned as a raw JSON string that clients must parse (e.g., `{"query": "..."}`). May be `null`.
outputsobjectoptional
Output data from the workflow. An empty object until outputs are available.
statusstringoptional
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.
total_stepsintegeroptional
Total number of workflow steps executed.
total_tokensintegeroptional
Total tokens consumed.
workflow_idstringoptional
Workflow ID.
400`not_workflow_app` : App mode does not match the API route.

One documented failure

  • not_workflow_app

    Please check if your app mode matches the right API route.

    not_workflow_app

404`not_found` : Workflow run not found.

One documented failure

  • not_found

    Workflow run not found.

    not_found

Error handling

A 400 is returned: not_workflow_app : App mode does not match the API route. A 404 is returned: not_found : Workflow run not found.