v20

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

Boot your computer from a sandbox image

Attach the sandbox image to the caller's computer, which re-provisions it from the pinned image (installed files are wiped). The image must have a ready build, and the computer provider must match the build's. Bodyless. Guest callers are denied (a write).

post/projects/{projectId}/images/{imageId}/use

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

imageIdstring required

Sandbox image ID, as returned by the project's image list.

Request body

object required

Response

The sandbox image was attached; the computer is re-provisioning.

imageIdstring required
computerIdstring required
statusstring required

The computer's lifecycle status after attaching (it re-provisions).