---
title: "GET /0/workers"
method: GET
path: "/0/workers"
---

# GET /0/workers

`GET /0/workers`

## Query parameters

- `active` boolean

## Response `200`

successful operation

- WorkersResult
  - `workers` Worker[], required
    - `bootstrap` boolean, required
    - `deleted` boolean, required
    - `diagnostics` boolean, required
    - `factory` string, required
    - `factory_ip` string, nullable
    - `factory_private` string, nullable
    - `hold` WorkerHold
      - `reason` string, required
      - `time` string, date-time, required
    - `id` string, required
    - `jobs` WorkerJob[], required
      - `id` string, required
      - `name` string, required
      - `owner` string, required
      - `state` string, required
      - `tags` object, required
    - `lastping` string, date-time, nullable
    - `recycle` boolean, required
    - `target` string, required

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

> 17 revisions in range; 1 not diffed.

- **2024-03-13** `8052886c11a6` — 1 info
  - added the optional property `workers/items/factory_ip` to the response with the `200` status
- **2024-03-11** `7962484a2c41` — 1 info
  - added the required property `workers/items/diagnostics` to the response with the `200` status
- **2024-02-28** `4973c53ff968` — 1 info
  - added the optional property `workers/items/hold` to the response with the `200` status
- **2024-01-09** `cf24b25fd671` — 1 info
  - api operation id `workers_list` removed and replaced with `workers_list_old`
- **2023-08-21** `ad085ef729f0` — 1 breaking, 2 warning, 1 info
  - removed the required property `workers/items/diagnostics` from the response with the `200` status
  - removed the optional property `workers/items/factory_ip` from the response with the `200` status
  - removed the optional property `workers/items/hold` from the response with the `200` status
  - api operation id `workers_list_old` removed and replaced with `workers_list`

[Change history](https://skmtc.dev/oxidecomputer/apis/buildomat/changes/0/workers/get.md)

---

[API](https://skmtc.dev/oxidecomputer/apis/buildomat.md) · [All operations](https://skmtc.dev/oxidecomputer/apis/buildomat/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oxidecomputer/buildomat/revisions/7c904bfdde4a/schema)