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
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?object

Filter by repository

GitHub repository

dataGithubRepository

GitHub repository

platformstring
Value in"github"

GitLab repository

dataGitlabRepository

GitLab repository

platformstring
Value in"gitlab"
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

curl -X GET "https://api.gitar.ai/v1/external/runs?page_size=0&page_token=string&status=string&data=%5Bobject+Object%5D&platform=github&date_from=2019-08-24T14%3A15%3A22Z&date_to=2019-08-24T14%3A15%3A22Z"
{
  "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"
}