Skip to main content
GET
List builds for the org

Permissions

Requires a service user with the ManageRepoBlueprints permission at the organization level.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

org_id
string
required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

Query Parameters

after
string | null
first
integer
default:100
Required range: 1 <= x <= 200
status
enum<string> | null

Filter by spec status.

Available options:
pending,
running,
succeeded,
failed,
cancelled
active
boolean | null

If true, returns 0 or 1 items: the build whose image is currently used by new sessions.

Response

Successful Response

items
Build · object[]
required
end_cursor
string | null

Cursor to fetch the next page, or None if this is the last page.

has_next_page
boolean
default:false

Whether there are more items available after this page.

total
integer | null

Optional total count (can be omitted for performance).