Monitor runs

Use the run ID returned at creation time. For a workflow run, that run ID is also the session ID. Phone and session details populate after Axilio allocates the phone; the ID does not change.

List and inspect runs

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Runs, choose your organization, and filter by workflow, trigger, or status. Open a run to inspect its session, phone, recording, and Telemetry.

axilio runs list --workflow wf_123
axilio runs get run_123

Add -o json for the complete machine-readable result.

runs = client.runs.list(workflow_id="wf_123", limit=20)
run = client.runs.get("run_123")

print(run.status, run.success, run.error_message)
print("session:", run.session_id)

runs, err := api.Runs.List(ctx, &platformgo.RunsListRequest{
    WorkflowID: platformgo.String("wf_123"),
    Limit:      platformgo.Int64(20),
})
if err != nil {
    log.Fatal(err)
}

run, err := api.Runs.Get(ctx, &platformgo.RunsGetRequest{
    RunID: "run_123",
})

REST API References:

List runs: GET /runs
Get a run: GET /runs/{run_id}

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

curl --silent --show-error --fail-with-body \
  --url "https://api.axilio.ai/api/v1/runs?workflow_id=wf_123&limit=20" \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/runs/run_123 \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

Watch a run

runs watch streams the run’s session Telemetry until the terminal status. It replays retained frames first when necessary, then resumes the live stream:

axilio runs watch run_123

In JSON mode, output is newline-delimited JSON: one object per frame followed by a final watch_end summary. It is not one JSON document. You can also follow a session directly:

axilio sessions trace sess_123 --follow

See Get started with Telemetry for SDK helpers and retained-data behavior.

Cancel a queued or running run

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Runs, select the run, and click Cancel. A completed, failed, or already canceled run is already terminal.

axilio runs cancel run_123 --yes

canceled = client.runs.cancel("run_123")
print(canceled.status)

canceled, err := api.Runs.Cancel(ctx, &platformgo.RunsCancelRequest{
    RunID: "run_123",
})

REST API References:

Cancel a run: POST /runs/{run_id}:cancel

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/runs/run_123:cancel \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

Read history and statistics

Recent runs and historical reporting are separate queries. Use history for a bounded time window and statistics for a workflow’s total and success rate.

CLI
Python SDK
Go SDK
REST API

axilio runs history --from 2026-08-01 --to 2026-08-28 --workflow wf_123
axilio runs stats wf_123

from datetime import datetime, timezone

history = client.runs.list_historic(
    start_date=datetime(2026, 8, 1, tzinfo=timezone.utc),
    end_date=datetime(2026, 8, 28, tzinfo=timezone.utc),
    workflow_id="wf_123",
)
stats = client.runs.stats("wf_123")
print(stats.total_runs, stats.success_rate)

history, err := api.Runs.ListHistoric(ctx, &platformgo.RunsListHistoricRequest{
    StartDate:  platformgo.MustParseDateTime("2026-08-01T00:00:00Z"),
    EndDate:    platformgo.MustParseDateTime("2026-08-28T00:00:00Z"),
    WorkflowID: platformgo.String("wf_123"),
})

stats, err := api.Runs.Stats(ctx, &platformgo.RunsStatsRequest{
    WorkflowID: "wf_123",
})

REST API References:

List run history: GET /runs/history
Get workflow stats: GET /runs/stats/{workflow_id}

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

curl --silent --show-error --fail-with-body \
  --url "https://api.axilio.ai/api/v1/runs/history?start_date=2026-08-01T00%3A00%3A00Z&end_date=2026-08-28T00%3A00%3A00Z&workflow_id=wf_123&limit=50&offset=0" \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/runs/stats/wf_123 \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

success_rate is a fraction from 0 to 1. Its denominator is completed plus failed runs. total_runs counts every lifecycle state.

Get Started

Phones and Sessions

Workflows and Runs

Files

Observability

Telemetry

Usage

Billing

Organization

Reference

List and inspect runs

Watch a run

Cancel a queued or running run

Read history and statistics

​List and inspect runs

​Watch a run

​Cancel a queued or running run

​Read history and statistics

List and inspect runs

Watch a run

Cancel a queued or running run

Read history and statistics