Run a workflow now
Runs a workflow immediately, without waiting for its trigger.
Check Get workflow run-now options first. If that reports requires_previous_run, pass one of the run IDs it offers as replay_from_run_id and the workflow runs again with that run’s payload. Otherwise send an empty body.
This executes the workflow for real: it calls whatever the definition calls and consumes credits. Runs started this way are recorded with is_test_run set to true, which is what keeps them out of the replay list on later calls.
The call returns as soon as the run is queued, so status is started rather than a result. Poll Get workflow run with the run_id to watch it finish.
Archived workflows cannot be run and return a 400. A replay_from_run_id whose payload no longer matches the workflow’s current trigger returns a 409, because replaying it would run the steps against fields that have since moved.
This endpoint is limited to 5 requests per minute.
Authorizations
Personal API key.
Path Parameters
ID of the app whose workflows you want to work with.
ID of the workflow, as returned in id by List workflows.
Body
Run whose trigger payload to reuse for this run. Required when Get workflow run-now options reports requires_previous_run; leave it out otherwise.
"0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77"
Response
The run is queued.
Always started. The run is queued, not finished.
"started"
Confirmation text you can show someone.
"Run started"
ID of the run that started. Pass it to Get workflow run to follow it.
"0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77"