Sign in

v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-035471202.8 KB
Sandbox images

Create a sandbox image

Create a personal-draft sandbox image from a blueprint and respond 201 with its detail. Build it (POST .../build) before a computer can boot from it. Guest callers are denied (a write).

post/projects/{projectId}/images

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

Request body

namestring required

Display name for the new sandbox image; must be non-empty after trimming.

blueprintstring required

Blueprint YAML defining the image. Validated server-side; use the validate endpoint for fast feedback.

Response

The sandbox image was created.

idstring required
projectIdstring required
namestring required
contentHashstring required
sharing'user' | 'project' required

user = a personal draft; project = shared with the whole project.

isOwnerboolean required
createdAtnumber required
updatedAtnumber required
blueprintstring required

The image's blueprint YAML (base / initialize / maintenance / knowledge). base must be an allowlisted official image pinned by sha256 digest.