Skip to main content
POST
/
api
/
v1
/
images
/
build
Initiate Image Build
curl --request POST \
  --url https://api.primeintellect.ai/api/v1/images/build \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image_name": "<string>",
  "image_tag": "<string>",
  "dockerfile_path": "Dockerfile",
  "platform": "linux/amd64",
  "teamId": "<string>",
  "visibility": "INHERIT"
}
'
{
  "build_id": "<string>",
  "upload_url": "<string>",
  "expires_in": 123,
  "fullImagePath": "<string>",
  "visibility": "PRIVATE"
}

​
Rate Limit

150 requests per 60 seconds per IP and token.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Request model for building an image.

​
image_name
string
required

Image name (e.g., 'myapp')

​
image_tag
string
required

Image tag (e.g., 'v1.0.0')

​
dockerfile_path
string
default:Dockerfile

Path to Dockerfile within build context

​
platform
enum<string>
default:linux/amd64

Target platform (linux/amd64 or linux/arm64)

Available options:
linux/amd64,
linux/arm64
​
teamId
string | null

Team ID if building image in team context

​
visibility
enum<string>
default:INHERIT

Visibility override to apply when the build completes. INHERIT preserves existing tag visibility or defaults new tags to PRIVATE.

Available options:
INHERIT,
PRIVATE,
PUBLIC

Response

Successful Response

Response model for initiating image build.

​
build_id
string
required

Build ID for tracking

​
upload_url
string
required

Presigned URL to upload build context (tar.gz)

​
expires_in
integer
required

URL validity in seconds

​
fullImagePath
string
required

Full image path with user ID

​
visibility
enum<string>
default:PRIVATE

Effective visibility for the image when the build completes

Available options:
PRIVATE,
PUBLIC