VoxLink.ai
Start Free

API Reference

List automation runs

List an automation's recent executions, or one execution's step-by-step detail

Updated 27 July 2026
On this page

This endpoint lists an automation's recent executions (newest first). Pass run_id to get one execution's step-by-step detail with a per-step classification — this is your debugger when an automation is failing.

Once you have fixed what made a run fail, retry it from its failed step with Retry automation run — take the run's id from this list.

Path Parameters

idstringrequired

The ID of the automation (from List automations)

Query Parameters

run_idstring

A run ID from the list — returns that run's step-by-step detail instead of the list

limitinteger

How many recent runs to list (1–20, default 10)

Response — list (no run_id)

runsarray

The automation's recent executions, newest first

idstring

  The run ID — pass it back as `run_id` for the step-by-step detail, or to [Retry automation run](/api-reference/automations/retry-automation-run) for a failed run

statusstring

  `SUCCEEDED`, `FAILED`, `PAUSED` (parked at a Delay step waiting for its target time — not a failure) or `RUNNING`

start_timestring

  When the run started

duration_msinteger

  The run's duration in milliseconds

Response — detail (with run_id)

runobject

The execution's detail

idstring

  The run ID

statusstring

  `SUCCEEDED`, `FAILED`, `PAUSED` or `RUNNING`

start_timestring

  When the run started

duration_msinteger

  The run's duration in milliseconds

stepsarray

  Per-step outcome — same shape as the `test.steps` of [Create automation](/api-reference/automations/create-automation): `{name, status, classification, error}`, where `classification` is `ok`, `paused_at_delay`, `wiring_error`, `missing_connection` or `missing_record`

A missing automation — or one that does not belong to your account — returns a 404 with {"message": "Automation not found"}. A run_id that does not belong to this automation returns a 404 with {"message": "Run not found for this automation"}.

{
  "runs": [
    {
      "id": "yHhXbqWj3zJZ5ztDNfUry",
      "status": "SUCCEEDED",
      "start_time": "2026-07-24T18:23:59.634Z",
      "duration_ms": 1
    },
    {
      "id": "x2PqLm90AbCdEfGhIjKlM",
      "status": "FAILED",
      "start_time": "2026-07-24T17:10:12.000Z",
      "duration_ms": 410
    }
  ]
}

{
  "run": {
    "id": "x2PqLm90AbCdEfGhIjKlM",
    "status": "FAILED",
    "start_time": "2026-07-24T17:10:12.000Z",
    "duration_ms": 410,
    "steps": [
      { "name": "trigger", "status": "SUCCEEDED", "classification": "ok", "error": null },
      {
        "name": "step_1",
        "status": "FAILED",
        "classification": "missing_connection",
        "error": "Request failed with status code 401"
      }
    ]
  }
}

{
  "message": "Run not found for this automation"
}

Related guides

API Reference

Introduction

Welcome to the VoxLink API

Read guide →

API Reference

Authentication

Learn how to authenticate your API requests

Read guide →

API Reference

Get current user

Get the authenticated user's profile information

Read guide →

API Reference

List assistants

List all assistants for the authenticated user with pagination

Read guide →