Runs

List Runs

Returns durable run summaries from the backing store, including runs persisted before the current server boot. Supports per-status filtering and sorting for both list and kanban renderings. Archived runs are hidden by default; pass include_archived=true (or status=archived) to include them. Runs in the removing bucket are hidden unless explicitly requested via status=removing.

get/api/v1/runs

Query parameters

page[limit]integer

Maximum number of items to return per page.

page[offset]integer

Number of items to skip before returning results.

include_archivedboolean

Whether to include archived runs in the response. Defaults to false.

parent_idstring

Return only runs currently linked to this orchestration parent.

statusBoardColumn[]

Filter runs by status bucket. Repeatable. When omitted, runs in the removing bucket are hidden; pass status=removing to include them. Archived runs are hidden unless include_archived=true or status=archived is passed.

Field to sort by. Defaults to created_at.

direction'asc' | 'desc'

Sort direction. Defaults to desc.

Response

Paginated durable run summaries

Example response

{
  "data": [
    {
      "repository": {
        "name": "fabro-sh/fabro",
        "origin_url": "https://github.com/fabro-sh/fabro.git"
      },
      "lifecycle": {
        "error": {
          "message": "Stage 'apply-changes' exceeded maximum retries."
        }
      },
      "timing": {
        "wall_time_ms": 420000,
        "inference_time_ms": 120000,
        "tool_time_ms": 60000,
        "active_time_ms": 180000
      },
      "diff": {
        "files_changed": 42,
        "additions": 567,
        "deletions": 234
      },
      "pull_request": {
        "owner": "fabro-sh",
        "repo": "fabro",
        "number": 123,
        "html_url": "https://github.com/fabro-sh/fabro/pull/123"
      },
      "current_question": {
        "text": "Accept or push for another round?"
      }
    }
  ]
}

Changes

Changed in 16 of the 134 revisions of this API.11432

Jul 28, 2026ef906071a8e412See the full diff
- ●
  added the new publish_failed enum value to the data/items/lifecycle/status/oneOf[RunStatusFailed]/reason response property for the response status 200
  response-property-enum-value-added
- ○
  the response property data/items/timing/oneOf[RunTiming]/inference_time_ms became required for the status 200
  response-property-became-required
- ○
  the response property data/items/timing/oneOf[RunTiming]/tool_time_ms became required for the status 200
  response-property-became-required
Jul 28, 20267fe7b675579921See the full diff
- ▲
  the response property data/items/timing/oneOf[RunTiming]/inference_time_ms became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/timing/oneOf[RunTiming]/tool_time_ms became optional for the status 200
  response-property-became-optional
- ○
  removed the publish_failed enum value from the data/items/lifecycle/status/oneOf[RunStatusFailed]/reason response property for the response status 200
  response-property-enum-value-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 20264f9aedeb721112See the full diff
- ●
  added the new publish_failed enum value to the data/items/lifecycle/status/oneOf[RunStatusFailed]/reason response property for the response status 200
  response-property-enum-value-added
- ○
  the response property data/items/timing/oneOf[RunTiming]/inference_time_ms became required for the status 200
  response-property-became-required
- ○
  the response property data/items/timing/oneOf[RunTiming]/tool_time_ms became required for the status 200
  response-property-became-required
Jul 28, 2026d043ecc9a6522See the full diff
- ▲
  the response property data/items/timing/oneOf[RunTiming]/inference_time_ms became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/timing/oneOf[RunTiming]/tool_time_ms became optional for the status 200
  response-property-became-optional
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 2026fa4de608a93c2See the full diff
- ○
  the response property data/items/timing/oneOf[RunTiming]/inference_time_ms became required for the status 200
  response-property-became-required
- ○
  the response property data/items/timing/oneOf[RunTiming]/tool_time_ms became required for the status 200
  response-property-became-required
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 27, 202644617fd2c7221See the full diff
- ○
  removed the publish_failed enum value from the data/items/lifecycle/status/oneOf[RunStatusFailed]/reason response property for the response status 200
  response-property-enum-value-removed
Jul 27, 2026ad4eeab2bd6f1See the full diff
- ●
  added the new publish_failed enum value to the data/items/lifecycle/status/oneOf[RunStatusFailed]/reason response property for the response status 200
  response-property-enum-value-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 13, 2026de85d055604012See the full diff
- ▲
  added PrincipalUser PrincipalWorker PrincipalWebhook PrincipalSlack PrincipalAgent PrincipalSystem to the data/items/created_by response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  added discriminator to data/items/created_by response property for the response status 200
  response-property-discriminator-added
- ○
  removed Principal subschema #2 from the data/items/created_by response property oneOf list for the response status 200
  response-property-one-of-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 27, 20261fa851815cf244See the full diff
- ▲
  removed the required property data/items/sandbox/oneOf[RunSandbox]/image from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/sandbox/oneOf[RunSandbox]/provider from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/sandbox/oneOf[RunSandbox]/runtime from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property data/items/sandbox/oneOf[RunSandbox]/snapshot from the response with the 200 status
  response-required-property-removed
- ○
  added the optional property data/items/sandbox/oneOf[RunSandbox]/failure to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/sandbox/oneOf[RunSandbox]/instance to the response with the 200 status
  response-optional-property-added
- ○
  added the required property data/items/sandbox/oneOf[RunSandbox]/kind to the response with the 200 status
  response-required-property-added
- ○
  added the required property data/items/sandbox/oneOf[RunSandbox]/plan to the response with the 200 status
  response-required-property-added
May 27, 2026682a04780c6e1See the full diff
- ○
  added the optional property data/items/automation/oneOf[AutomationRef]/trigger_id to the response with the 200 status
  response-optional-property-added

Full history (16 revisions)