Poll build logs

GET

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

• Production admin API

Returns incremental build log content for a specific profile build so API clients can watch queued and running builds.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Profile identifier.

buildId

required

string

Build identifier.

Query Parameters

after

integer

Return chunks with an ID greater than this value. Start with 0 or omit it.

Responses

200

Incremental build log payload.

object

status

required

string

Allowed values: queued running succeeded failed

chunk

required

Concatenated log output returned since the requested cursor.

string

next_after

required

Cursor value to send in the next polling request.

integer

done

required

True when the build is in a terminal state and there are no more log chunks to read.

boolean

Examples

Build is still queued

{
  "status": "queued",
  "chunk": "",
  "next_after": 0,
  "done": false
}

Build is producing logs

{
  "status": "running",
  "chunk": "starting nix build\\ncopying sources\\n",
  "next_after": 18,
  "done": false
}

Build completed and no more chunks remain

{
  "status": "succeeded",
  "chunk": "build completed successfully\\n",
  "next_after": 24,
  "done": true
}

400

Invalid polling cursor.

object

error

required

string

Examples

Invalid after value

{
  "error": "Invalid after value"
}

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"
}