---
title: "List Runs Endpoint"
method: GET
path: "/auto-agent/runs"
tags: ["auto-agent"]
---

# List Runs Endpoint

`GET /auto-agent/runs`

List all Auto Agent runs for the authenticated user.

Args:
    limit: Max runs to return (default 50).
    offset: Pagination offset.
    auth: Authenticated user.

Returns:
    List of run summaries, most recent first.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- AutoAgentRunListResponse — Response for listing Auto Agent runs. Args: runs: List of run summaries. count: Number of runs in this response.
  - `runs` AutoAgentRunSummary[] — List of run summaries
    - `run_id` string, required — Run UUID
    - `status` string, required — running | complete | failed | stopped
    - `message` string — User task description
    - `project_id` string, nullable — Project ID for this run
    - `tool_calls_made` integer — Number of tool calls executed
    - `created_at` string, required — ISO timestamp of run creation
    - `completed_at` string, nullable — ISO timestamp of completion
    - `error_message` string, nullable — Error description if failed
  - `count` integer — Number of runs returned

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/revisions/31dfe831e079/schema)