Skip to content
Fleeti

Create profile build

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

Queues a new build for a profile the authenticated API key owner can manage.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Profile identifier.

Request Body required

Section titled “Request Body required ”
object
fleet_id
required

Fleet identifier. The selected fleet must already be assigned to the profile.

string
version
required

Build version using v-prefixed semver.

string
Examples

Queue a new build

{
  "fleet_id": "fleet-primary",
  "version": "v1.4.0"
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Build queued successfully.

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

Queued build 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": "queued",
    "installer_status": "not_requested",
    "created_at": "2026-03-20 11:30:00"
  }
}

400

Section titled “400 ”

Invalid build request.

object
error
required
string
Examples

Invalid build version

{
  "error": "Version must use semver format like v1.1.0"
}

401

Section titled “401 ”

Missing or invalid API key.

object
error
required
string

403

Section titled “403 ”

The authenticated user cannot manage the profile or selected fleet.

object
error
required
string

404

Section titled “404 ”

Profile not found or not visible to the authenticated user.

object
error
required
string