Skip to main content
POST
Build a container image

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)

dockerConfig
string

Docker configuration JSON containing credentials for the source registry.

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). References with a registry hostname start an asynchronous import that downloads and converts the image for the resource runtime.

memoryMb
integer

Memory for the registry import worker in MiB. Only supported when image is a registry reference. When omitted, the platform default is used.

Required range: 1 <= x <= 32768
Example:

16384

volumeMb
integer

Temporary scratch disk for the registry import worker in MiB. Only supported when image is a registry reference. When omitted, the platform default is used. Set to 0 to use memory-backed scratch. Positive values are not supported for HIPAA workspaces.

Required range: 0 <= x <= 131072
Example:

32768

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 September 25, 2026