KEkernel

List builds

Changed on
get/builds

Request

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

Query parameters

tagsTags

User-defined key-value tags.

Filter builds by tag key-value pairs.

{
  "team": "backend",
  "env": "staging"
}

Response

List of builds

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

  • b00eacfe26b2Revision changes
    • info

      added the optional property / to the response with the status

  • d3b8f05f7a0fRevision changes
    • warning

      deleted the query request parameter metadata

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional query request parameter tags

    • info

      added the optional property / to the response with the status