Builds

`GET /builds`

List builds across the org, with filters. Query params:

Param	Description
`projectId`	Filter to one project
`buildSettingId`	Filter to one build setting
`status`	`pending`, `running`, `complete`, `failed`, `superseded`
`platform`, `buildType`	Filter
`branch`	Filter
`limit`, `cursor`	Pagination

Response:

{
  "items": [
    {
      "id": "...",
      "projectId": "...",
      "buildSettingId": "...",
      "status": "complete",
      "platform": "Win64",
      "buildType": "Development",
      "branch": "main",
      "commit": "a1b2c3d...",
      "commitMessage": "Fix lighting in level 3",
      "ueVersion": "5.4",
      "triggeredBy": "user:...",
      "createdAt": "...",
      "finishedAt": "...",
      "durationMs": 763000
    }
  ],
  "nextCursor": "..."
}

`GET /builds/:id`

Build detail, including the most recent log lines.

`GET /builds/:id/download`

Get a signed URL for the artifact tarball.

curl https://api.buildpixel.io/builds/$BUILD_ID/download \
  -H "Authorization: Bearer $TOKEN"

Response:

{
  "url": "https://...",
  "expiresAt": "...",
  "sizeBytes": 4823482910,
  "checksumMd5": "a1b2..."
}

The URL is good for 24 hours. Refetch when needed. 404 not_found if the build never produced an artifact (failed before stage) or the artifact has been deleted by retention.

Overview

Endpoints

Real-time

Webhooks

`GET /builds`

`GET /builds/:id`

`GET /builds/:id/download`

​GET /builds

​GET /builds/:id

​GET /builds/:id/download

`GET /builds`

`GET /builds/:id`

`GET /builds/:id/download`