---
title: "List Agent Runs"
method: GET
path: "/v1/agent-runs/"
tags: ["agent_runs"]
---

# List Agent Runs

`GET /v1/agent-runs/`

Retrieve scheduled or event-triggered agent run outputs.

- Results are scoped to the authenticated API key's organization.
- Results are sorted by run creation time in descending order
  (newest first).
- List results include output previews; fetch a single run for the full
  final output.
- agent_id and agent_workflow_id are mutually exclusive; supplying both
  returns a 400.

## Query parameters

- `agent_id` string, nullable — Filter to runs from a native scheduled agent ID. Mutually exclusive with agent_workflow_id.
- `agent_workflow_id` string, nullable — Filter to runs from a legacy agent workflow ID. Mutually exclusive with agent_id.
- `user_id` string, nullable — Filter to runs owned by a user ID.
- `call_id` string, nullable — Filter to runs associated with a call ID.
- `cursor` string, nullable — Cursor for pagination
- `limit` integer — Number of items per page
- `direction` 'next' | 'prev' — Pagination direction

## Response `200`

Successful Response

- PaginatedResponseAgentRunPreview
  - `data` AgentRunPreview[], required
    - `id` string, required
    - `title` string, nullable
    - `agent_id` string, nullable
    - `agent_workflow_id` string, nullable
    - `user_id` string, required
    - `call_id` string, nullable
    - `output_status` 'has_output' | 'no_text_output', required — Whether a run currently has final text output.
    - `output_preview` string, nullable
    - `created_at` string, nullable
    - `last_updated_at` string, nullable
  - `pagination` CursorPagination, required — Cursor-based pagination.
    - `next_cursor` string, nullable
    - `previous_cursor` string, nullable

## Other responses

- `400` — agent_id and agent_workflow_id are mutually exclusive
- `401` — Unauthorized - Invalid or missing API key
- `422` — Validation Error

---

[API](https://skmtc.dev/glyphic/apis/airspeed-api.md) · [All operations](https://skmtc.dev/glyphic/apis/airspeed-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/glyphic/airspeed-api/revisions/87cd819002a7/schema)