v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB

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/runs/{workflow_id}

Path parameters

workflow_idstring uuid required

workflow to create runs for

Request body

$schemastring uri

A URL to the JSON Schema for this object.

start_timeout_secondsinteger

How long a queued run may wait for a phone before it is auto-cancelled.

Example request

{
  "$schema": "/api/v1/RunCreateRequest.json"
}

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

run_idsstring[] nullable required

List of created run identifiers.

Example response

{
  "$schema": "/api/v1/RunCreateResponse.json"
}