SandboxesLifecycle

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.

PUT
/v1/sandboxes/{idOrName}/reset
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

idOrName*string

Sandbox ID (ULID) or name

Query Parameters

org?string

Required when the path names the sandbox by name.

project?string

Required when the path names the sandbox by name.

Response Body

application/json

application/problem+json

curl -X PUT "https://example.com/v1/sandboxes/string/reset"
{  "id": "string",  "state": "creating"}