v2

latestOpenAPI 3.1.02026-07-2675166192.8 KB

Images

Build Vm Image

Build a VM image from an existing container image.

Converts the image's current registry content into a VM image without rebuilding the container image. If the image already has a VM artifact, this triggers a rebuild while keeping the registered artifact available until the replacement completes. Requires VM sandboxes to be enabled for the owning account and a linux/amd64 image; for team images, only the image creator or team admins may trigger it. Poll /images/build/{build_id} for progress.

post/api/v1/images/{image_name}/{image_tag}/vm-build

Path parameters

image_namestring required

image_tagstring required

Request body

teamIdstring nullable

Team ID if the image is a team image

ownerScope'platform' nullable

Set to 'platform' to build a VM artifact for an org-less platform image (platform admins only)

Response

Successful Response

successboolean required

Whether the build was queued

messagestring required

Status message describing the result

buildIdstring required

Public build ID of the image's build group, for status polling

artifactBuildIdstring required

Build row ID of the new VM artifact leg