---
title: "List builders"
method: GET
path: "/builders"
---

# List builders

`GET /builders`

## Request

- Base URL: `http://localhost:4973`
- URL: `http://localhost:4973/builders`
- Auth: HTTP bearer

## Query parameters

- `tags` Tags: User-defined key-value tags.

## Response `200`

List of builders

- Builder[]
  - `id` string, required: Builder identifier
  - `name` string: Optional non-unique display name
  - `disk_size_gb` integer, required: Persistent builder cache disk size in gigabytes. Cannot be changed after creation.
  - `status` 'ready' | 'pruning' | 'deleting' | 'error', required: Builder lifecycle status
  - `tags` Tags: User-defined key-value tags.
  - `created_at` string, date-time, required: Creation timestamp (RFC3339)
  - `last_used_at` string, date-time, nullable: When a build last ran on this builder
  - `max_concurrency` integer, required: Maximum concurrent builds on this builder. Currently fixed at 1.
  - `active_build_id` string, nullable: Point-in-time ID of the build currently running on this builder
  - `queued_builds` string[], required: Point-in-time IDs of queued builds waiting for this builder, oldest first

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

## Changes

- **2026-08-21** `b00eacfe26b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kernel/apis/hypeman-api/changes/builders/get.md)

---

[API](https://skmtc.dev/kernel/apis/hypeman-api.md) - [All operations](https://skmtc.dev/kernel/apis/hypeman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kernel/apis/hypeman-api/revisions/befe3f654ef6?raw)