v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB

platformApi

Api Workflow Runs Create

Execute a workflow manually. Returns the completed result or a paused run id for workflows with async (human) steps.

post/api/workflow-runs/

Headers

Authorizationstring required

JWT access token or Respan API key

Request body

workflow_idstring required

Workflow ID (or versioned ID 'workflow_id:version') to execute.

payloadobject

event_typestring nullable

Response

statusstring required

'completed' or 'paused'.

{"stackTrail":"components:schemas:WorkflowRunExecutionResponse:properties:results","oasType":"schema","type":"unknown","description":"Final output(s) on sync completion."}

workflow_run_idstring

Run id to resume later (paused runs only).

paused_at_stepstring nullable

Label of the step that paused the run.