Run (test) a workflow now — confirm-gated
POST/v1/workflows/:workflow_id/run
Run a workflow immediately by id.
Optional inputs become the trigger payload the first node reads. This is a
real execution against real data — nodes send email, write to the CRM and call
live integrations — so the call is confirm-gated: without confirm: true you
get back what would run, and with it the workflow executes and the response
carries the execution id.
Follow up with GET /v1/workflows/executions/{execution_id} to see per-node
results. Requires the workflows:run scope.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
Successful Response
Error
Error
Error
Error
Validation Error
Error