Run a workflow

One entry in runs creates one run. Its unique run ID is also used as the session ID when the phone starts it.

Queue a run

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Workflows.
Select the workflow and click Run.
Choose Run Now.
Choose Use Dedicated Phones, then select one or more phones.
Set Number of Runs and Queue Timeout (min), then start the run.

axilio runs start wf_123 --start-timeout 300

Add --watch to follow the one run immediately after creating it.

from axilio import RunConfig

result = client.runs.create(
    "wf_123",
    runs=[RunConfig(variables=[{"query": "coffee"}])],
    start_timeout_seconds=300,
)
run_id = result.run_ids[0]

result, err := api.Runs.Create(ctx, &platformgo.RunCreateRequest{
    WorkflowID: "wf_123",
    Runs: []*platformgo.RunConfig{
        {
            Variables: []map[string]any{{"query": "coffee"}},
        },
    },
    StartTimeoutSeconds: platformgo.Int64(300),
})
if err != nil {
    log.Fatal(err)
}
runID := result.RunIDs[0]

REST API References:

Start a run: POST /workflows/{workflow_id}/runs

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --request POST \
  --url https://api.axilio.ai/api/v1/workflows/wf_123/runs \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "runs": [{"variables": [{"query": "coffee"}]}],
    "start_timeout_seconds": 300
  }'

start_timeout_seconds is the number of seconds a queued run may wait for a phone before Axilio cancels it. The accepted range is 60–86,400 seconds. The default is 300. The dashboard sends its visible 30-minute queue timeout unless you change it.

Runs queue immediately. The current public request contract has no future start time or recurring schedule. In Workflows, choose Run Now; do not rely on the visible Schedule option.

Run in parallel

Create one run entry per execution:

CLI
Python SDK
Go SDK
REST API

axilio runs start wf_123 --count 3

result = client.runs.create(
    "wf_123",
    runs=[RunConfig(variables=[{}]) for _ in range(3)],
)
print(result.run_ids)

result, err := api.Runs.Create(ctx, &platformgo.RunCreateRequest{
    WorkflowID: "wf_123",
    Runs: []*platformgo.RunConfig{
        {Variables: []map[string]any{{}}},
        {Variables: []map[string]any{{}}},
        {Variables: []map[string]any{{}}},
    },
})

REST API References:

Start a run: POST /workflows/{workflow_id}/runs

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --request POST \
  --url https://api.axilio.ai/api/v1/workflows/wf_123/runs \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "runs": [
      {"variables": [{}]},
      {"variables": [{}]},
      {"variables": [{}]}
    ]
  }'

The endpoint accepts 1–1,000 entries per request.

Concurrency and phone availability determine how many runs execute at once. The remainder stay queued until a phone becomes available or their start timeout expires.

Select dedicated phones

Set phone_id on each run entry when that run must use one exact dedicated phone:

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Workflows, select the workflow, and click Run.
Choose Run Now and set Number of Runs.
Enable Use Dedicated Phones and select one or more active, idle phones.
Set Queue Timeout (min) and start the run.

When you select fewer phones than runs, Axilio assigns the selected phones to runs in round-robin order.

axilio runs start wf_123 --phone-id ph_123

result = client.runs.create(
    "wf_123",
    runs=[
        RunConfig(phone_id="ph_123", variables=[{}]),
        RunConfig(phone_id="ph_456", variables=[{}]),
    ],
)

result, err := api.Runs.Create(ctx, &platformgo.RunCreateRequest{
    WorkflowID: "wf_123",
    Runs: []*platformgo.RunConfig{
        {
            PhoneID:   platformgo.String("ph_123"),
            Variables: []map[string]any{{}},
        },
        {
            PhoneID:   platformgo.String("ph_456"),
            Variables: []map[string]any{{}},
        },
    },
})
if err != nil {
    log.Fatal(err)
}

REST API References:

Start a run: POST /workflows/{workflow_id}/runs

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --request POST \
  --url https://api.axilio.ai/api/v1/workflows/wf_123/runs \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "runs": [
      {"phone_id": "ph_123", "variables": [{}]},
      {"phone_id": "ph_456", "variables": [{}]}
    ]
  }'

Axilio stores and delivers run variables to workflow code as plaintext. Do not put passwords, API keys, or other secrets in variables.

Get Started

Phones and Sessions

Workflows and Runs

Files

Observability

Telemetry

Usage

Billing

Organization

Reference

Run a workflow

Queue a run

Run in parallel

Select dedicated phones

Next steps

Monitor runs

Live Telemetry

​Queue a run

​Run in parallel

​Select dedicated phones

​Next steps

Monitor runs

Live Telemetry

Queue a run

Run in parallel

Select dedicated phones

Next steps