Skip to main content
POST
Resume a sandbox
Resume a suspended or resume_failed sandbox from its retained checkpoint, preserving the sandbox ID. For resume_failed, an accepted retry clears the previous error_details and starts another attempt using the original snapshot_id. Another attempt can fail; acceptance is not a guarantee of recovery.
  • This path accepts either the sandbox ID or the sandbox name.
  • Tensorlake returns 202 Accepted when resume is pending. Read Get Sandbox until status is running before executing commands.
  • Tensorlake returns 200 OK when the sandbox is running. Success responses have no JSON body.
  • Pass wait_ms to wait for the transition, up to 30000 ms. An unfinished wait returns 202; a failed or superseded lifecycle request can return 409 Conflict.
  • An unsupported state or a missing or unusable checkpoint returns 400 Bad Request.
After an error or client timeout, read the current sandbox metadata. Do not classify recovery from an HTTP status or error message alone. Only resume_failed confirms this recoverable failure state; pending with retained_runtime.state: resume_uncertain remains unresolved. See Recover from a failed resume for a bounded recovery flow. Proxy traffic never retries resume_failed, regardless of auto_resume. Proxy traffic can resume a suspended named sandbox when auto_resume is true (the default). When it is false, the proxy returns HTTP 409 with code SANDBOX_AUTO_RESUME_DISABLED instead. This explicit resume endpoint works regardless of auto_resume and does not change it. If it is false, the sandbox still rejects proxy-triggered resume after its next suspension. To re-enable automatic resume, update the sandbox with auto_resume: true.

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.

Query Parameters

wait_ms
integer<uint64>
default:0

Wait for readiness for up to this many milliseconds, capped at 30000. Defaults to 0 (asynchronous acceptance). Expiry returns 202 and does not cancel the attempt.

Required range: x >= 0

Response

Sandbox is running. Empty response body.