---
title: "List the agent runs in a repository, newest first"
method: GET
path: "/api/v1/agents/{forge}/{owner}/{repo}/runs"
tags: ["Project Agents"]
---

# List the agent runs in a repository, newest first

`GET /api/v1/agents/{forge}/{owner}/{repo}/runs`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/agents/{forge}/{owner}/{repo}/runs`
- Auth: none declared

The runs in this repository of the agents of the project that owns it, archived agents' included. Requires pull on the repository; each run leaves out the Environment it pinned and who pays for it.

## Path parameters

- `forge` 'gh' | 'et', required
- `owner` string, required
- `repo` string, required

## Query parameters

- `agent_id` string
- `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out' | 'canceled'
- `per_page` integer
- `cursor` string

## Response `200`

A page of the repository's runs

- object
  - `items` object[], required
    - `id` string, required
    - `agent` object, required: The agent, at the version and under the name the run pinned.
      - `id` string, required
      - `version` integer, required
      - `name` string, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out' | 'canceled', required
    - `trigger` object, required
      - `kind` 'push' | 'manual' | 'retry', required
      - `id` string, nullable, required
    - `trail_id` string, required: The product Trail of the Change it reviewed.
    - `change_id` string, required: The Change it reviewed.
    - `error` object, nullable, required: Why the run failed, timed out or was canceled.
      - `code` string, nullable, required
      - `message` string, required
    - `attempt` integer, required
    - `retry_of` string, nullable, required: The run this one retried; null for a first attempt.
    - `created_at` string, required
    - `updated_at` string, required
  - `next_cursor` string

## Other responses

- `400`: Invalid run query
- `401`: Not authenticated
- `403`: Agents feature disabled
- `404`: Repository not found, or repository pull is missing
- `502`: Agents service unavailable

## Changes

- **2026-10-26** `82deb2eae7c6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/agents/:forge/:owner/:repo/runs/get.md)

---

[API](https://skmtc.dev/entire/apis/entire-api.md) - [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/entire/apis/entire-api/revisions/a24dfcc828d7?raw)