Sign in

v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-175267122.5 KB

List builds

get/builds

Query parameters

tagsobject

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

Instance ID of the builder VM (for debugging)

Example response

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