List 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.

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

List Agent Runs

cURL

curl --request GET \
  --url https://api.codegen.com/v1/organizations/{org_id}/agent/runs

200

{
  "items": [
    {
      "id": 123,
      "organization_id": 123,
      "status": "<string>",
      "created_at": "<string>",
      "web_url": "<string>",
      "result": "<string>",
      "summary": "<string>",
      "github_pull_requests": [
        {
          "id": 123,
          "created_at": "<string>",
          "title": "<string>",
          "url": "<string>",
          "head_branch_name": "<string>"
        }
      ],
      "metadata": {}
    }
  ],
  "total": 123,
  "page": 123,
  "size": 123,
  "pages": 123
}

Headers

Path Parameters

org_id · integer · required

Query Parameters

user_id · integer | null

Filter by user ID who initiated the agent runs

source_type · enum<string> | null

Filter by source type of the agent runs

Available options: LOCAL, SLACK, GITHUB, GITHUB_CHECK_SUITE, GITHUB_PR_REVIEW, LINEAR, API, CHAT, JIRA, CLICKUP, MONDAY, SETUP_COMMANDS

skip · integer · default: 0

Required range: x >= 0

limit · integer · default: 100

Required range: 1 <= x <= 100

Response

200

application/json

Successful Response

items · AgentRunResponse · object[] · required

Show child attributes

total · integer · required

page · integer · required

size · integer · required

pages · integer · required