---
title: "POST /0/factory/worker"
method: POST
path: "/0/factory/worker"
---

# POST /0/factory/worker

`POST /0/factory/worker`

## Request body

- FactoryWorkerCreate
  - `job` string, nullable
  - `target` string, required
  - `wait_for_flush` boolean

## Response `201`

successful creation

- FactoryWorker
  - `bootstrap` string, required
  - `hold` boolean, required
  - `id` string, required
  - `online` boolean, required
  - `private` string, nullable
  - `recycle` boolean, required
  - `target` string, required

## Other responses

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

## Changes

> 17 revisions in range; 1 not diffed.

- **2024-03-11** `7962484a2c41` — 1 info
  - added the required property `target` to the response with the `201` status
- **2024-02-28** `4973c53ff968` — 1 info
  - added the required property `hold` to the response with the `201` status
- **2023-08-21** `ad085ef729f0` — 2 breaking
  - removed the required property `hold` from the response with the `201` status
  - removed the required property `target` from the response with the `201` status

[Change history](https://skmtc.dev/oxidecomputer/apis/buildomat/changes/0/factory/worker/post.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)