Skip to main content
GET
List Runs

Authorizations

Authorization
string
header
required

Raw dev token passed as Authorization: Bearer fabro_dev_... when server.auth.methods includes dev-token.

Query Parameters

page[limit]
integer
default:20

Maximum number of items to return per page.

Required range: 1 <= x <= 100
page[offset]
integer
default:0

Number of items to skip before returning results.

Required range: x >= 0
include_archived
boolean
default:false

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

parent_id
string

Return only runs currently linked to this orchestration parent.

status
enum<string>[]

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.

Status bucket for a run, shared by list and kanban renderings and by the status query parameter on GET /api/v1/runs. The archived bucket is orthogonal to the include_archived flag — passing status=archived is equivalent to opting archived runs in.

Available options:
pending,
runnable,
initializing,
running,
blocked,
succeeded,
failed,
archived,
removing
sort
enum<string>
default:created_at

Field to sort by. Defaults to created_at.

Available options:
created_at,
updated_at,
status,
elapsed,
repo,
title,
workflow,
changes,
size
direction
enum<string>
default:desc

Sort direction. Defaults to desc.

Available options:
asc,
desc

Response

200 - application/json

Paginated durable run summaries

Paginated list of runs.

data
object[]
required
meta
object
required

Pagination metadata included in every paginated response.