Reset a sandbox
Hard-reset a running sandbox — like pulling the power. Unlike reboot-sandbox the guest gets no shutdown signal and its filesystem is not flushed first, so recently written, un-synced files may be lost. The VM restarts from the same disk on the same node; the disk and IP are preserved. A pending resize applies on reset.
Hard-reset a running sandbox — like pulling the power. Unlike reboot-sandbox the guest gets no shutdown signal and its filesystem is not flushed first, so recently written, un-synced files may be lost. The VM restarts from the same disk on the same node; the disk and IP are preserved. A pending resize applies on reset.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Sandbox ID (ULID)
Response Body
application/json
application/problem+json
curl -X POST "https://api-dev.tektona.ai/v1/sandboxes/string/reset"{ "$schema": "https://api-dev.tektona.ai/schemas/RebootSandboxResponseBody.json", "id": "string", "state": "string"}{ "$schema": "https://api-dev.tektona.ai/schemas/ErrorModel.json", "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"}Reboot a sandbox POST
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.
Resize a sandbox PUT
Change the CPU, memory, or disk allocation of a sandbox. Only provided fields change. Disk is grow-only. Downsizing memory requires force. Changes take effect on the sandbox's next start or resume.