---
title: "List Agent Runs"
method: GET
path: "/v1/organizations/{org_id}/agent/runs"
tags: ["agents", "agents", "agents"]
---

# List Agent Runs

`GET /v1/organizations/{org_id}/agent/runs`

List agent runs for an organization with optional user filtering.

Returns a paginated list of agent runs for the specified organization.
Optionally filter by user_id to get only agent runs initiated by a specific user.
Results are ordered by creation date (newest first).

Rate limit: 60 requests per 30 seconds.

## Path parameters

- `org_id` integer, required

## Query parameters

- `user_id` integer, nullable — Filter by user ID who initiated the agent runs
- `source_type` 'LOCAL' | 'SLACK' | 'GITHUB' | 'GITHUB_CHECK_SUITE' | 'GITHUB_PR_REVIEW' | 'LINEAR' | 'API' | 'CHAT' | 'JIRA' | 'CLICKUP' | 'MONDAY' | 'SETUP_COMMANDS'
- `skip` integer
- `limit` integer

## Headers

- `authorization` unknown

## Response `200`

Successful Response

- PageAgentRunResponse
  - `items` AgentRunResponse[], required
    - `id` integer, required
    - `organization_id` integer, required
    - `status` string, nullable
    - `created_at` string, nullable
    - `web_url` string, nullable
    - `result` string, nullable
    - `summary` string, nullable
    - `source_type` 'LOCAL' | 'SLACK' | 'GITHUB' | 'GITHUB_CHECK_SUITE' | 'GITHUB_PR_REVIEW' | 'LINEAR' | 'API' | 'CHAT' | 'JIRA' | 'CLICKUP' | 'MONDAY' | 'SETUP_COMMANDS'
    - `github_pull_requests` GithubPullRequestResponse[], nullable
      - `id` integer, required
      - `title` string, nullable
      - `url` string, nullable
      - `created_at` string, required
      - `head_branch_name` string, nullable
    - `metadata` object, nullable
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required

## Other responses

- `403` — Forbidden
- `422` — Validation Error
- `429` — Too Many Requests

## Changes

- **2025-08-21** `a0215d4f2c07` — 1 warning, 1 info
  - added the new `SETUP_COMMANDS` enum value to the `items/items/source_type/anyOf[subschema #1: ApiAgentRunSourceType]/` response property for the response status `200`
  - added the enum value `SETUP_COMMANDS` to the property `anyOf[subschema #1: ApiAgentRunSourceType]/` of the `query` request parameter `source_type`
- **2025-08-15** `69bfde65bf75` — 4 breaking, 3 warning, 5 info
  - the response property `items/items/github_pull_requests/anyOf[subschema #1]/items/title` became optional for the status `200`
  - the response property `items/items/github_pull_requests/anyOf[subschema #1]/items/url` became optional for the status `200`
  - response property `items/items/github_pull_requests/anyOf[subschema #1]/items/title` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/github_pull_requests/anyOf[subschema #1]/items/url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …8 more
- **2025-06-26** `4b2b8862eea6` — 2 info
  - added the optional property `items/items/github_pull_requests` to the response with the `200` status
  - added the optional property `items/items/metadata` to the response with the `200` status
- **2025-06-13** `70e15e0c5ef2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/codegen-sh/apis/developer-api/changes/v1/organizations/:org_id/agent/runs/get.md)

---

[API](https://skmtc.dev/codegen-sh/apis/developer-api.md) · [All operations](https://skmtc.dev/codegen-sh/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codegen-sh/developer-api/revisions/e68a3133f727/schema)