List profile builds

GET

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

• Production admin API

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

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Profile identifier.

Responses

200

Builds associated with the requested profile.

object

builds

required

Array<object>

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

{
  "builds": [
    {
      "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": "queued",
      "installer_status": "not_requested",
      "created_at": "2026-03-20 11:30:00"
    },
    {
      "id": "3a5b2dc6-6737-47e5-a10d-e2e7bdad4d78",
      "profile_id": "a8ce71df-4c80-4d45-919a-bfd474a4d724",
      "profile_name": "Production Base",
      "fleet_id": "fleet-secondary",
      "fleet_name": "Secondary Fleet",
      "profile_revision_id": "90ce5188-b7cc-42f7-a8dd-c5523fec7dfc",
      "profile_revision": 13,
      "version": "v1.3.1",
      "status": "succeeded",
      "artifact": "updates/builds/v1.3.1",
      "installer_status": "succeeded",
      "installer_artifact": "updates/installers/v1.3.1",
      "created_at": "2026-03-19 08:15:00"
    }
  ]
}

401

Missing or invalid API key.

object

error

required

string

404

Profile not found or not visible to the authenticated user.

object

error

required

string