GET
List builds

Authorizations

api-key
string
header
required

Per-project server key, prefixed sk_live_. Full access to every endpoint. Keep it on your backend: never ship it in a game binary.

Query Parameters

project_id
string

Which project to act on. Required when authenticating with a developer session (bearer_auth), which names no project of its own; ignored when authenticating with an API key, which carries its project already.

A project belonging to another account returns PROJECT_NOT_FOUND (7001) rather than a 403, so this cannot be used to probe for project ids.

Example:

"proj_abc123"

status
enum<string>
Available options:
uploading,
processing,
ready,
failed,
deleted
build_type
enum<string>
Available options:
zip,
docker_image
name
string

Filter by build name, the value servers use as version_tag.

limit
integer
default:50

Maximum number of items to return.

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

Number of items to skip before collecting the result set.

Required range: x >= 0

Response

A page of builds.

Envelope fields shared by every list endpoint.

total
integer
required

Total number of items matching the query, ignoring pagination.

Example:

100

limit
integer
required
Example:

50

offset
integer
required
Example:

0

has_more
boolean
required

Whether more items exist past offset + limit.

Example:

true

data
object[]
required