Sandboxes

Saved project deletion is separate from compute termination. Sleep refuses active commands and retains original limits.

post/v1/sandboxes/{id}/wake

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Headers

Idempotency-Keystring required

Stable key for this logical operation. Reuse the same key and body after an uncertain response.

Request body

object required

Response

Success

idstring required
state'creating' | 'ready' | 'running' | 'idle' | 'suspended' | 'resuming' | 'recovering' | 'terminated' | 'failed' | 'freezing' | 'frozen' required
created_atstring date-time required
updated_atstring date-time required
last_activity_atstring date-time required
terminal_atstring date-time nullable
cost_usdnumber required

Customer cost recorded for this sandbox.

charge_state'estimated' | 'final'

Present for metered sandboxes. A terminal sandbox remains estimated while required cost records are unavailable. Show Finalizing cost until final. Historical contracts omit this field.

final_charge_usdnumber

Immutable aggregate lifetime compute charge once charge_state is final. This amount is independent of current-month readings and excludes ongoing retained-file usage. Retaining files can continue to incur separate usage charges after compute is final. Omitted while the compute cost is finalizing.

urlstring uri required

Console URL for this sandbox.

warningsstring[]

Nonfatal warnings, including bootstrap_failed when the setup command fails.

setup_statestring
setup_failurestring
last_successful_save_atstring date-time

Last verified nonempty saved project. Absence does not imply saved application progress.

started_atstring date-time

First observed tool readiness for the current direct workspace compute session. Absent while starting and on legacy sessions without this timestamp. This is separate from creation time and changes with a replacement session.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property envelope/outcome/max_cost_usd deprecated

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      response property envelope/outcome/max_cost_usd reactivated