Gitar Logo
EnterpriseAPI Reference

List agent runs

List agent runs with pagination and filtering. Returns runs in reverse chronological order (newest first). Requires Administrator scope.

GET
/external/runs

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

page_size?integer

Number of runs to return per page (1-100, default 10)

Formatint64
page_token?string

Cursor token for pagination

status?string

Filter by run status (e.g., "queued", "working", "completed", "failed")

repository?|

Filter by repository

date_from?string

Filter by date range - start date (inclusive)

Formatdate-time
date_to?string

Filter by date range - end date (inclusive)

Formatdate-time

Response Body

application/json

application/json

curl -X GET "https://api.gitar.ai/v1/external/runs"
{
  "next_token": "string",
  "page_size": 0,
  "runs": [
    {
      "branch_name": "string",
      "created_at": "string",
      "repository": {
        "data": {
          "owner": "string",
          "repo": "string"
        },
        "platform": "github"
      },
      "run_id": "string",
      "status": "string",
      "updated_at": "string"
    }
  ],
  "total_count": 0
}
Empty
Empty
Empty
Empty
{
  "message": "string"
}