Stop a pod sandbox
Suspends the pod: its volume is kept, and the next turn of a session attached to it (or a PUT) starts it again. Refused during a turn (sandbox_busy).
AuthorizationBearer <token>An application key of the Tenant (PUT /v1/tenant/keys/{keyId}), or Studio's key, derived from the admin key. With Nylorun-Subject and Nylorun-Scopes, it acts for that person, narrowed to those scopes. Never accepted from a browser (Origin).
sandboxId*stringThe sandbox id, percent-encoded: team-a%2Fproj-42 for team-a/proj-42
Nylorun-Protocol*stringThe protocol version, 8
Nylorun-Subject?stringThe person an application key acts for
Nylorun-Scopes?stringThe subject's space-separated scopes; required with a subject
The sandbox
application/json- response
id*stringkind*string"virtual""pod"labels*spec*state*string"ready""creating""running""stopped"pod?sessions*array<>createdAt*stringupdatedAt*stringcurl -X POST "https://example.com/v1/sandboxes/string/stop" \ -H "Nylorun-Protocol: string"{ "id": "string", "kind": "virtual", "labels": { "property1": "string", "property2": "string" }, "spec": { "property1": null, "property2": null }, "state": "ready", "pod": { "desired": "running", "observed": "creating", "volumeGeneration": 0, "hostEpoch": 0, "expiresAt": "string", "reason": "string" }, "sessions": [ { "id": "string", "activeTurnId": "string" } ], "createdAt": "string", "updatedAt": "string"}Read a sandbox's lifecycle events GET
`sandbox.created`, `sandbox.attached`, `sandbox.detached` and `sandbox.deleted`, in order, numbered from 0.
Reset a pod sandbox POST
A new pod on a new, empty volume; the old pod and volume are deleted. The way out of `sandbox_lost`. Refused during a turn (`sandbox_busy`).