Build a container image

Builds a container image without creating a deployment. Returns a presigned URL for uploading source code. After upload, the image will be built and stored in the registry, but no agent, function, sandbox, or job will be created or updated.

POST /images

Build a container image

cURL

curl --request POST \
  --url https://api.blaxel.ai/v0/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "resourceType": "<string>",
  "generation": "<string>",
  "image": "<string>"
}
'

200

{
  "image": "<string>",
  "message": "<string>",
  "name": "<string>",
  "resourceType": "<string>"
}

Authorizations

OAuth2ApiKeyAuth

Authorization · string · header · required

OAuth2 authentication with JWT tokens

Body

application/json

name · string · required

Name of the image to build

resourceType · string · required

Resource type (agent, function, sandbox, job)

generation · string

Runtime generation (e.g., mk3). Defaults to mk3 if not specified.

image · string

A pre-built Docker image reference (e.g., docker.io/myorg/myimage:latest). When provided, the build step is skipped and the image is used directly as the source for the resource runtime.

Response

200

application/json

successful operation

image · string

The registered image reference (only present when image was provided in request)

message · string

Status message

name · string

Name of the image

resourceType · string

Resource type