---
title: "List agent runs"
method: GET
path: "/api/agents/{agentId}/runs"
tags: ["Platform API"]
---

# List agent runs

`GET /api/agents/{agentId}/runs`

List safe run summaries for one configured Outlit agent. Read-only.

## Path parameters

- `agentId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Agent run summaries were returned.

- ListAgentRunsCommandSuccess
  - `ok` true, required
  - `commandId` 'agent.run.list', required
  - `commandVersion` 1, required
  - `correlationId` string, required
  - `result` object, required
    - `operationId` 'agent.run.list', required
    - `status` 'completed', required
    - `resources` CommandResource[], required
      - `type` string, required
      - `id` string, required
    - `data` object, required
      - `runs` AgentRunSummary[], required
        - `id` string, required
        - `runId` string, required
        - `agentId` string, required
        - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'PARTIAL', required
        - `trigger` 'manual' | 'scheduled' | 'event' | 'signal' | 'null', nullable, required
        - `summary` string, nullable, required
        - `errorSummary` string, nullable, required
        - `sandboxStatus` string, nullable, required
        - `startedAt` string, date-time, required
        - `endedAt` string, date-time, nullable, required
        - `durationMs` integer, nullable, required
        - `counts` AgentRunCounts, required
          - `candidates` integer, required
          - `tools` integer, required
          - `artifacts` integer, required
          - `outputs` integer, required
        - `outputs` AgentRunOutputSummary[], required
          - `id` string, required
          - `status` 'PENDING' | 'VALID' | 'INVALID' | 'PROCESSED', required
          - `deliveryStatus` 'NOT_REQUIRED' | 'PENDING' | 'SENT' | 'FAILED' | 'PARTIAL', required
          - `deliveredAt` string, date-time, nullable, required
          - `createdAt` string, date-time, required
      - `pagination` object, required
        - `hasMore` boolean, required
        - `nextCursor` string, nullable, required
    - `warnings` string[], required
    - `auditId` string

## Other responses

- `401` — Invalid or missing API key.
- `403` — The API key is valid but does not have the required agent read scope.
- `404` — No agent was found for the authenticated organization and requested agent ID.
- `500` — Internal server error.
- `503` — The platform could not list agent runs.

---

[API](https://skmtc.dev/outlitai/apis/outlit-api.md) · [All operations](https://skmtc.dev/outlitai/apis/outlit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outlitai/apis/outlit-api/revisions/1ea769da8e31?raw)