List sandboxes
Every sandbox with all the labels asked for. A token caller sees only the sandboxes its grants reach.
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).
limit?integer1 <= value <= 200cursor?stringlabel?|array<string>key=value; repeat it to require several labels
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 sandboxes; limit opts into pagination
application/json- response
sandboxes*array<>import { createClient } from "@nylorun/agents";const client = await createClient();const sandboxes = await client.sandboxes.list({ labels: { team: "ops" } });{ "sandboxes": [ { "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" } ]}Delete a sandbox DELETE
Deletes the sandbox and its files. Sessions attached to it stay attached by id; their next turn is refused until a sandbox with this id exists again.
Read a sandbox's lifecycle events GET
`sandbox.created`, `sandbox.attached`, `sandbox.detached` and `sandbox.deleted`, in order, numbered from 0.