Sign in
Workflow Runs

Run Workflow by ID

Available for: Workflow apps.

Execute a specific workflow version identified by its ID. Useful for running a particular published version of the workflow.

post/workflows/{workflow_id}/run

Path parameters

workflow_idstring required

Workflow ID of the specific version to execute. This value is returned in the workflow_id field of Run Workflow responses and Get Workflow Run Detail.

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