KEkernel

Prune builder cache

Changed on

Resets the builder's cache disk. The builder transitions to pruning, then ready. Builder identity is preserved.

post/builders/{id}/prune

Request

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

Path parameters

idstring required

Builder ID

Response

Prune accepted

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