---
title: "Add a new Image Build"
method: POST
path: "/orgs/{orgId}/images/{imageId}/builds"
tags: ["public", "Image"]
---

# Add a new Image Build

`POST /orgs/{orgId}/images/{imageId}/builds`

DEPRECATED: This endpoint exists for historical compatibility and should not be used. Please use the [Artefact API](https://api-docs.humanitec.com/#tag/Artefact) instead.

This endpoint is used by Continuous Integration (CI) pipelines to notify Humanitec that a new Image Build is available.

If there is no Image with ID `imageId`, it will be automatically created.

## Path parameters

- `orgId` string, required
- `imageId` string, required

## Request body

- ImageBuildRequest — DEPRECATED: This type exists for historical compatibility and should not be used. Please use the [Artefact API](https://api-docs.humanitec.com/#tag/Artefact) instead. Holds the metadata associated withe a Container Image Build
  - `branch` string — The branch name of the branch the build was built on
  - `commit` string — The commit ID that this build was built from.
  - `image` string — The fully qualified Image URL including registry, repository and tag.
  - `tags` string[] — The tag that the build was built from.

## Response `204`

Build successfully added.

## Other responses

- `400` — The supplied `imageId` is invalid or a required field is missing.
- `401` — Request unauthorised.
- `403` — A build cannot be added to a builtin image.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)