---
title: "Get builder details"
method: GET
path: "/builders/{id}"
---

# Get builder details

`GET /builders/{id}`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

Builder details

- 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
- `404`: Builder not found
- `500`: Internal server error

## Changes

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

[Operation history](https://skmtc.dev/kernel/apis/hypeman-api/changes/builders/:id/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)