v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB
images

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

Request body

generationstring

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

imagestring

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.

namestring required

Name of the image to build

resourceTypestring required

Resource type (agent, function, sandbox, job)

Response

successful operation

imagestring

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

messagestring

Status message

namestring

Name of the image

resourceTypestring

Resource type