List builds

GET

/v1/projects/{id}/builds

• Web API (Projects, Maps, Content, Query, Analytics, Alerts, Data)

Returns the build IDs seen for a project, newest first. A build is any non-empty build_id that produced performance-bearing events in the selected window. Used by CI tooling to pick build IDs for comparison.

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Project UUID.

Query Parameters

days

integer

default: 30

Allowed values: 7 14 30 90

Time period in days.

buildId

string

>= 1 characters <= 256 characters

Fetch one specific build outside the newest-50 window.

fresh

string

Set to 1 to bypass the ~60s aggregation cache.

Responses

200

Array of builds.

object

success

boolean

data

Array<object>

Build ID observed in performance-bearing telemetry.

object

build_id

required

Non-empty build identifier reported by the SDK.

string

first_seen

required

Timestamp string of the first event seen for this build.

string

last_seen

required

Timestamp string of the most recent event seen for this build.

string

event_count

required

Number of performance-bearing events in the selected window.

integer

session_count

required

Approximate number of sessions for this build.

integer

player_count

required

Approximate number of players for this build.

integer

Headers

X-RateLimit-Limit

integer

Maximum number of requests allowed per hour.

X-RateLimit-Remaining

integer

Number of requests remaining in the current window.

X-RateLimit-Reset

integer

Unix timestamp when the rate limit window resets.

400

Invalid request parameters or body.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object

type

required

Problem type URI; about:blank when no specific type applies.

string format: uri

default: about:blank

title

required

Short, human-readable summary of the problem type.

string

status

required

HTTP status code.

integer

detail

Human-readable explanation specific to this occurrence.

string

error_category

Extension member categorizing the error.

string

Allowed values: authentication authorization validation rate_limit not_found conflict payload internal

retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean

retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer

401

Missing or invalid API key.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object

type

required

Problem type URI; about:blank when no specific type applies.

string format: uri

default: about:blank

title

required

Short, human-readable summary of the problem type.

string

status

required

HTTP status code.

integer

detail

Human-readable explanation specific to this occurrence.

string

error_category

Extension member categorizing the error.

string

Allowed values: authentication authorization validation rate_limit not_found conflict payload internal

retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean

retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer

404

Resource not found.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object

type

required

Problem type URI; about:blank when no specific type applies.

string format: uri

default: about:blank

title

required

Short, human-readable summary of the problem type.

string

status

required

HTTP status code.

integer

detail

Human-readable explanation specific to this occurrence.

string

error_category

Extension member categorizing the error.

string

Allowed values: authentication authorization validation rate_limit not_found conflict payload internal

retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean

retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer

429

Rate limit exceeded.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object

type

required

Problem type URI; about:blank when no specific type applies.

string format: uri

default: about:blank

title

required

Short, human-readable summary of the problem type.

string

status

required

HTTP status code.

integer

detail

Human-readable explanation specific to this occurrence.

string

error_category

Extension member categorizing the error.

string

Allowed values: authentication authorization validation rate_limit not_found conflict payload internal

retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean

retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer

Headers

X-RateLimit-Limit

integer

Maximum number of requests allowed per hour.

X-RateLimit-Remaining

integer

Number of requests remaining in the current window.

X-RateLimit-Reset

integer

Unix timestamp when the rate limit window resets.

Retry-After

integer

Number of seconds to wait before retrying. Present only on 429 responses. Because the limit uses a sliding window, honor this value per response rather than scheduling a retry for the reset time.