KEkernel

List builders

Changed on
get/builders

Request

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

Query parameters

tagsTags

User-defined key-value tags.

Filter builders by tag key-value pairs.

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

Response

List of builders

idstring required

Builder identifier

namestring

Optional non-unique display name

disk_size_gbinteger required

Persistent builder cache disk size in gigabytes. Cannot be changed after creation.

status'ready' | 'pruning' | 'deleting' | 'error' required

Builder lifecycle status

tagsTags

User-defined key-value tags.

created_atstring date-time required

Creation timestamp (RFC3339)

last_used_atstring date-time nullable

When a build last ran on this builder

max_concurrencyinteger required

Maximum concurrent builds on this builder. Currently fixed at 1.

active_build_idstring nullable

Point-in-time ID of the build currently running on this builder

queued_buildsstring[] required

Point-in-time IDs of queued builds waiting for this builder, oldest first

Example response

[
  {
    "id": "tz4a98xxat96iws9zmbrgj3a",
    "name": "team-cache",
    "disk_size_gb": 50,
    "tags": {
      "team": "backend",
      "env": "staging"
    },
    "max_concurrency": 1
  }
]

Changes