---
title: "Changes to Initiate Image Build"
method: POST
path: "/api/v1/images/build"
---

# Changes to Initiate Image Build

`POST /api/v1/images/build`

> Every recorded change to this operation, newest first.
> 49 revisions in range; 1 not diffed.

## Timeline

Changed in 4 of 49 revisions.

- **2026-11-04** `7f032a9306b0`: 1 info
- **2026-09-23** `5a35543613fd`: 2 info
- **2026-07-13** `bc121f7153d7`: 5 breaking, 8 info
- **2026-05-19** `8277f2bd6e99`: 1 info

## Changes

- **2026-11-04** `7f032a9306b0`: 1 info
  - added the new optional request property `registryAuth`
- **2026-09-23** `5a35543613fd`: 2 info
  - added `#/components/schemas/BulkBuildImageResponse` to the response body `anyOf` list for the response status `201`
  - removed `#/components/schemas/BulkImageTransferResponse` from the response body `anyOf` list for the response status `201`
- **2026-07-13** `bc121f7153d7`: 5 breaking, 8 info
  - the response's body type changed from `object` to no type for status `201`
  - removed the required property `build_id` from the response with the `201` status
  - removed the required property `expires_in` from the response with the `201` status
  - removed the required property `fullImagePath` from the response with the `201` status
  - removed the required property `upload_url` from the response with the `201` status
  - added the new optional request property `ownerScope`
  - added the new optional request property `sourceImage`
  - added the new optional request property `visibility`
  - the request property `image_name` became optional
  - the request property `image_tag` became optional
  - request property `image_name` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `image_tag` list-of-types was widened by adding types `null` to media type `application/json`
  - added `#/components/schemas/BuildImageResponse, #/components/schemas/BulkImageTransferResponse` to the response body `anyOf` list for the response status `201`
- **2026-05-19** `8277f2bd6e99`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/primeintellect/apis/pi-api/docs/api/v1/images/build/post.md) - [API](https://skmtc.dev/primeintellect/apis/pi-api.md) - [Page](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/images/build/post)