Skip to main content
GET
List Builds

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

org
string
required

Query Parameters

page
integer
default:1

Page number, counting from 1

Required range: 1 <= x <= 1000000
per_page
integer
default:15

Number of results per page. 0 returns no results, only the total count

Required range: 0 <= x <= 50
repo_id
string | null

Filter by external VCS repo ID

repo_name
string | null

Filter by repo name (e.g. 'cyber-dojo/differ')

repo_inner_id
string | null

Filter by the repo's internal id (the id in the repo response). The stable identifier: unaffected by repo renames or a missing external VCS id.

start_ts
number | null

Include builds created at or after this timestamp. Defaults to 28 days before end_ts

end_ts
number | null

Include builds created at or before this timestamp. Defaults to now

Response

200 - application/json

Successful Response

page
integer
required

Number of this page, counting from 1

per_page
integer
required

Maximum number of items on a page

total_pages
integer
required

Number of pages the full result fills

total_count
integer
required

Number of items across all pages

builds
BuildItemResponse · object[]
required

Links to related resources, keyed by relation (self, next, ...), each a link or a list of links

has_builds_ever
boolean | null