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

# List runs

`GET /runs`

List deferred runs within one project.

## Query parameters

- `projectId` string, uuid — Project ID to list runs for. Auto-filled from CLI and SDK context when omitted.
- `limit` integer — Maximum number of runs to return per page.
- `cursor` string, date-time — Cursor from a previous response's nextCursor to fetch the next page.

## Response `200`

OK

- object
  - `runs` object[], required
    - `id` string, uuid, required
    - `threadId` string, uuid, required
    - `userMessageId` string, uuid, nullable, required
    - `assistantMessageId` string, uuid, nullable, required
    - `workflowRunId` string, nullable, required
    - `status` 'processing' | 'completed' | 'aborted' | 'error', required
    - `source` 'app' | 'api' | 'mcp' | 'slack' | 'teams' | 'linear' | 'github' | 'agent' | 'cli' | 'web' | 'sdk' | 'bitbucket' | 'system', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `completedAt` string, date-time, nullable, required
  - `nextCursor` string, date-time, nullable, required — Pass as 'cursor' to fetch the next page. Null when there are no more results.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) · [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sazabi/sazabi-public-api/revisions/1d12b71c735a/schema)