---
title: "List coding-agent execution runs"
method: GET
path: "/api/v1/agent-runs"
tags: ["Execution"]
---

# List coding-agent execution runs

`GET /api/v1/agent-runs`

## Request

- Base URL: `https://www.specky.space`
- URL: `https://www.specky.space/api/v1/agent-runs`
- Auth: HTTP bearer

Returns provider-neutral handoff records for Cursor, Claude Code, Codex, Copilot, Cursor Cloud Agent, Modern.dev, Devin, Jules, and other agents. Each run includes separate CI and deployment signals; a merged pull request is not treated as proof of production deployment. Runs are always scoped to the authenticated workspace.

## Query parameters

- `status` 'queued' | 'pending_assignment' | 'assigned' | 'awaiting_agent' | 'in_progress' | 'awaiting_review' | 'changes_requested' | 'passed' | 'failed' | 'blocked' | 'cancelled'
- `q` string
- `limit` integer

## Response `200`

Successful response. Always includes `summary` (string) and `ok: true`; mutating endpoints additionally include the created resource id under a tool-specific key.

- OkSummary
  - `ok` true
  - `summary` string: Human-readable result text.

## Other responses

- `401`: Missing or invalid bearer token

---

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