Sign in
Runs

Start a run

Creates one or more runs against the given workflow and queues them for execution. Pre-flight checks: balance sufficient, concurrency limit, workflow exists. Runs that fail to queue are marked FAILED immediately so they stop counting toward the concurrency limit.

post/workflows/{workflow_id}/runs

Path parameters

workflow_idstring uuid required

workflow to create runs for

workflow to create runs for

Request body

start_timeout_secondsinteger

How long a queued run may wait for a phone before it is auto-cancelled (60-86400). Defaults to 300.

Response

Created

run_idsstring[] nullable required

List of created run identifiers.

Changes