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}

Request

  • Base URL
    https://api.dify.ai/v1
  • URL
    https://api.dify.ai/v1/workflows/run/{workflow_run_id}
  • Auth
    HTTP bearer

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.

created_atinteger

Unix timestamp of when the workflow run was created.

elapsed_timenumber float nullable

Total time elapsed in seconds, excluding time the run spent paused.

errorstring nullable

Error message if the workflow failed.

finished_atinteger nullable

Unix timestamp of when the workflow run finished.

idstring uuid

Workflow run ID.

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.

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.

total_stepsinteger

Total number of workflow steps executed.

total_tokensinteger

Total tokens consumed.

workflow_idstring uuid

Workflow ID.

Changes

No recorded changes to this operation across all 17 revisions of this API.