KEkernel

Create builder

Changed on

Creates a builder and its cache disk. One build at a time runs per builder.

post/builders

Request

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

Request body

idstring

Optional caller-supplied identifier, auto-generated if not provided

namestring

Optional non-unique display name

disk_size_gbinteger

Cache disk size in gigabytes. Omit to use the server default.

tagsTags

User-defined key-value tags.

Example request

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

Response

Builder created

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