Get build details

Changed on
get/builds/{id}

Request

  • Base URL
    http://localhost:4973
  • URL
    http://localhost:4973/builds/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Build ID

Response

Build details

idstring required

Build job identifier

status'queued' | 'building' | 'pushing' | 'ready' | 'failed' | 'cancelled' required

Build job status

tagsTags

User-defined key-value tags.

queue_positioninteger nullable

Position in build queue (only when status is queued)

image_digeststring nullable

Digest of built image (only when status is ready)

image_refstring nullable

Full image reference (only when status is ready)

errorstring nullable

Error message (only when status is failed)

created_atstring date-time required

Build creation timestamp

started_atstring date-time nullable

Build start timestamp

completed_atstring date-time nullable

Build completion timestamp

duration_msinteger nullable

Build duration in milliseconds

builder_instance_idstring nullable

Disposable VM instance that executed this build; distinct from builder_id

builder_idstring nullable

Persistent Builder resource whose cache backed this build

Example response

{
  "id": "build-abc123",
  "tags": {
    "team": "backend",
    "env": "staging"
  }
}

Changes

    • info

      added the optional property to the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status