---
title: "Start Image Build"
method: POST
path: "/api/v1/images/build/{build_id}/start"
tags: ["Images"]
---

# Start Image Build

`POST /api/v1/images/build/{build_id}/start`

Start the image build process after uploading the build context.

This creates a sandbox with Docker-in-Docker to build and push the image.

## Path parameters

- `build_id` string, required

## Request body

- StartBuildRequest — Request model to start the build after upload.
  - `context_uploaded` boolean — Confirmation that context was uploaded

## Response `200`

Successful Response

- BuildStatusResponse — Response model for a logical build group.
  - `id` string, required — Public identifier for the logical build group
  - `imageName` string, required — Name of the image being built
  - `imageTag` string, required — Tag of the image being built
  - `status` 'PENDING' | 'UPLOADING' | 'BUILDING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `createdAt` string, date-time, required — Timestamp when the build was created
  - `startedAt` string, date-time, nullable — Timestamp when the build started
  - `completedAt` string, date-time, nullable — Timestamp when the build completed
  - `artifacts` BuildArtifactStatusResponse[] — Artifact rows associated with this build group
    - `id` string, required — Internal identifier for this artifact build row
    - `artifactType` 'CONTAINER_IMAGE' | 'VM_SANDBOX'
    - `status` 'PENDING' | 'UPLOADING' | 'BUILDING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
    - `fullImagePath` string, nullable — Output reference for this built artifact
    - `errorMessage` string, nullable — Error message if build failed
    - `createdAt` string, date-time, required — Timestamp when the artifact row was created
    - `startedAt` string, date-time, nullable — Timestamp when the artifact row started
    - `completedAt` string, date-time, nullable — Timestamp when the artifact row completed

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

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