Get profile build

GET

/api/v1/profiles/{id}/builds/{buildId}

• Production admin API

Returns a specific build for a profile visible to the authenticated API key owner.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Profile identifier.

buildId

required

string

Build identifier.

Responses

200

Requested build.

object

build

required

object

id

required

string

profile_id

required

string

profile_name

string

fleet_id

string

fleet_name

string

profile_revision_id

required

string

profile_revision

required

integer

>= 1

version

required

string

status

required

string

Allowed values: queued running succeeded failed

artifact

string

installer_status

required

string

Allowed values: not_requested queued running succeeded failed

installer_artifact

string

created_at

required

UTC timestamp string returned by the current API implementation.

string

Examples

Example response

{
  "build": {
    "id": "0f124946-c8f1-47a0-a030-cbc28fb6f1d2",
    "profile_id": "a8ce71df-4c80-4d45-919a-bfd474a4d724",
    "profile_name": "Production Base",
    "fleet_id": "fleet-primary",
    "fleet_name": "Primary Fleet",
    "profile_revision_id": "53267f7c-7a0f-4f16-a02d-befc64c4ddf4",
    "profile_revision": 14,
    "version": "v1.4.0",
    "status": "succeeded",
    "artifact": "updates/builds/v1.4.0",
    "installer_status": "queued",
    "created_at": "2026-03-20 11:30:00"
  }
}

401

Missing or invalid API key.

object

error

required

string

404

Profile or build not found, or the build does not belong to the requested profile.

object

error

required

string

Examples

Missing build

{
  "error": "Build not found"
}