Pause a sandbox
Pause a running sandbox via hibernate or suspend mode.
Pause a running sandbox via hibernate or suspend mode.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Sandbox ID (ULID)
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Pause mode.
"hibernate"Value in
- "hibernate"
- "suspend"
Response Body
application/json
application/problem+json
curl -X PUT "https://example.com/v1/sandboxes/string/pause" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "string", "state": "string"}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}List state transitions GET
List state transitions for a sandbox, newest first.
Reboot a sandbox PUT
Orderly cold-reboot of a running sandbox: the guest shuts its processes down (SIGTERM, then SIGKILL a few seconds later) and flushes its filesystem before the VM is stopped and started again from the same disk on the same node. In-memory state and running processes are lost, but recently written files survive; the disk and IP are preserved. If the guest doesn't respond within a few seconds it falls back to a hard reset, in which case un-synced writes can be lost. A pending resize applies on reboot. For an unconditional hard reset, use reset-sandbox.