A repo's most recent runs, newest first (ADR-0046) — the dashboard's per-repo history and pass/fail chart source. Scoped to the repo's tenant.

GET

/v1/repos/{org}/{repo}/runs

curl --request GET \
  --url https://example.com/v1/repos/example/example/runs

Parameters

Path Parameters

org

required

string

Org slug

repo

required

string

Project (repo) name

Query Parameters

limit

integer format: int32

Max runs (default 50, capped 200)

Responses

200

Media typeapplication/json

GET /v1/runs body: the most recent runs, newest first.

object

runs

required

Array<object>

One run in the list view: identity, status, creation time (epoch millis), and — when the run was stamped at creation (ADR-0049) — its owning tenant.

object

actor

The Actor login — who caused the trigger (UI labels it “author”).

string | null

created_at

required

integer format: int64

duration_ms

required

Run duration in millis: updated_at - created_at. For a terminal run this is its total wall time; for an in-flight run, elapsed-to-last-update. Drives the dashboard’s per-run bar heights (ADR-0046).

integer format: int64

git_ref

The symbolic branch/tag ref the run ran on.

string | null

id

required

string

org

The owning org, if the run is tenanted (trigger-created).

string | null

origin_pr_base

The PR base branch (ADR-0057) — the branch a pull_request run targets, rendered base ← head in the ref cluster. A discrete origin fact; absent for non-PR runs and runs created before base-stamping.

string | null

pipeline

The pipeline this run executed (the bare .scarab/<name> selection). Absent for inline runs and runs created before pipeline-stamping.

string | null

pr_number

The pull-request number, for pull_request runs.

integer | null format: int64

project

The owning project (repo name), if tenanted.

string | null

run_number

The run number (ADR-0057 amendment) — the per-repo sequential #N, the human handle shown in the run-list gutter. Absent for untenanted inline runs and runs created before run-number allocation. Distinct from the opaque, unguessable id.

integer | null format: int64

sha

The resolved commit the run pinned to.

string | null

status

required

string

trigger_kind

The run’s origin — the trigger facts it was born from, each stamped at creation and independently nullable (sparse across trigger kinds; all absent on runs created before origin-stamping). The trigger kind (push/pull_request/tag/…).

string | null

trigger_title

The run Headline (ADR-0057) — the one human line saying what this run is about (a push’s commit subject; later a PR title / dispatch reason), disambiguated by the trigger kind. Display/audit only; absent when the trigger carried no headline and on runs created before headline-stamping.

string | null

Example^generated

{
  "runs": [
    {
      "actor": "example",
      "created_at": 1,
      "duration_ms": 1,
      "git_ref": "example",
      "id": "example",
      "org": "example",
      "origin_pr_base": "example",
      "pipeline": "example",
      "pr_number": 1,
      "project": "example",
      "run_number": 1,
      "sha": "example",
      "status": "example",
      "trigger_kind": "example",
      "trigger_title": "example"
    }
  ]
}