Sandbox images

Boot your computer from a sandbox image

Changed on

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/images/{imageId}/use
  • Auth
    HTTP bearer

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

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • info

      endpoint added