Workflow Runs

Run Workflow by ID

Changed on

Available for: Workflow apps.

Run a specific published workflow version, identified by the workflow_id in the path. Request body, response, and streaming behavior match Run Workflow; only the executed version differs.

post/workflows/{workflow_id}/run

Request

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

Path parameters

workflow_idstring required

Published workflow version to run. Returned in the workflow_id field of Run Workflow responses and Get Workflow Run Detail. Must reference a published version; a draft version ID is rejected with bad_request.

Request body

WorkflowExecutionRequest required(unresolved $ref)

Response

Successful response. The content type and structure depend on the response_mode parameter in the request.

  • If response_mode is blocking, returns application/json with a WorkflowBlockingResponse object.
  • If response_mode is streaming, returns text/event-stream with a stream of ChunkWorkflowEvent objects.
task_idstring uuid

Task ID for the in-progress execution. Use this with Stop Workflow Task to cancel a running workflow. Only valid during execution.

workflow_run_idstring uuid

Persistent identifier for this workflow run record. Use this with Get Workflow Run Detail to retrieve results after execution.

Changes