---
title: "Changes to Create a new build"
method: POST
path: "/builds"
---

# Changes to Create a new build

`POST /builds`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 51 revisions.

- **2026-10-19** `9787f2320a2e`: 1 info
- **2026-08-21** `b00eacfe26b2`: 4 info
- **2026-03-09** `d3b8f05f7a0f`: 2 warning, 2 info
- **2026-03-07** `48572ed07140`: 2 info
- **2026-02-26** `57c5cb3d3dc5`: 2 info
- **2026-02-15** `88202634e62d`: 1 info
- **2026-01-27** `fbe706932aed`: 3 info
- **2026-01-09** `cadf3c04bd1b`: 1 info

## Changes

- **2026-10-19** `9787f2320a2e`: 1 info
  - added the non-success response with the status `501`
- **2026-08-21** `b00eacfe26b2`: 4 info
  - added the new optional request property `builder_id`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the optional property `builder_id` to the response with the `202` status
- **2026-03-09** `d3b8f05f7a0f`: 2 warning, 2 info
  - removed the request property `metadata`
  - removed the optional property `metadata` from the response with the `202` status
  - added the new optional request property `tags`
  - added the optional property `tags` to the response with the `202` status
- **2026-03-07** `48572ed07140`: 2 info
  - added the new optional request property `metadata`
  - added the optional property `metadata` to the response with the `202` status
- **2026-02-26** `57c5cb3d3dc5`: 2 info
  - added the new optional request property `cpus`
  - added the new optional request property `memory_mb`
- **2026-02-15** `88202634e62d`: 1 info
  - added the new optional request property `image_name`
- **2026-01-27** `fbe706932aed`: 3 info
  - added the new optional request property `global_cache_key`
  - added the new optional request property `is_admin_build`
  - added the optional property `builder_instance_id` to the response with the `202` status
- **2026-01-09** `cadf3c04bd1b`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kernel/apis/hypeman-api/docs/builds/post.md) - [API](https://skmtc.dev/kernel/apis/hypeman-api.md) - [Page](https://skmtc.dev/kernel/apis/hypeman-api/changes/builds/post)