Skip to main content
POST
/
images
Build a container image
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>"
}
'
{
  "image": "<string>",
  "message": "<string>",
  "name": "<string>",
  "resourceType": "<string>"
}

Authorizations

​
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

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

Last modified on March 31, 2026