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).

Changes

Changed in 2 of the 122 revisions of this API.71

Jul 25, 20268e393fd5825f7See the full diff
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new CONFLICT enum value to the response property for the response status
  response-property-enum-value-added
Jul 25, 2026302cc2d08c561See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history