---
title: "Start a run"
method: POST
path: "/runs/{workflowID}"
tags: ["Runs"]
---

# Start a run

`POST /runs/{workflowID}`

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.

## Path parameters

- `workflowID` string, required — workflow to create runs for

## Request body

- RunRunCreateRequest
  - `numberOfRuns` integer, required
  - `runTime` RunRunTimeConfig, required
    - `isImmediate` boolean, required
    - `isScheduled` boolean, required
    - `scheduleTime` string
    - `scheduleTimeoutSeconds` integer, required
  - `runs` RunRunConfig[], nullable, required
    - `phoneId` string
    - `variables` object[], nullable, required

## Response `201`

Created

- RunRunCreateResponse
  - `run_ids` string[], nullable, required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/versions/d7ecf9466d6d/schema)