Skip to main content
POST
Suspend a sandbox
Suspend a named running sandbox while preserving its state for resume. A paused VM may remain available; suspension does not require destroying it.
  • This path accepts either the sandbox ID or the sandbox name.
  • Only named sandboxes can be suspended. Ephemeral sandboxes return 400 Bad Request.
  • Tensorlake returns 202 Accepted when suspension starts or is already in progress.
  • Tensorlake returns 200 OK when the sandbox is already suspended.
Calling suspend on resume_failed does not clear the diagnosis or retry the sandbox. Use Resume Sandbox for recovery. Suspension preserves auto_resume. With its default value, true, subsequent proxy traffic can wake the sandbox. Set it to false through Update Sandbox before suspension to keep the sandbox suspended until you explicitly resume it. You can also change this setting while already suspended without waking it.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

sandbox_id
string
required

The sandbox ID or sandbox name.

Response

Sandbox was already suspended