Skip to main content
POST
/
api
/
v1
/
images
/
build
/
{build_id}
/
start
Start Image Build
curl --request POST \
  --url https://api.primeintellect.ai/api/v1/images/build/{build_id}/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "context_uploaded": true
}
'
{
  "id": "<string>",
  "imageName": "<string>",
  "imageTag": "<string>",
  "status": "PENDING",
  "createdAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "artifacts": [
    {
      "id": "<string>",
      "status": "PENDING",
      "createdAt": "2023-11-07T05:31:56Z",
      "artifactType": "CONTAINER_IMAGE",
      "fullImagePath": "<string>",
      "errorMessage": "<string>",
      "startedAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

build_id
string
required

Body

application/json

Request model to start the build after upload.

context_uploaded
boolean
default:true

Confirmation that context was uploaded

Response

Successful Response

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
enum<string>
required

Aggregated build-group status

Available options:
PENDING,
UPLOADING,
BUILDING,
COMPLETED,
FAILED,
CANCELLED
createdAt
string<date-time>
required

Timestamp when the build was created

startedAt
string<date-time> | null

Timestamp when the build started

completedAt
string<date-time> | null

Timestamp when the build completed

artifacts
BuildArtifactStatusResponse · object[]

Artifact rows associated with this build group