List an Agent's disk versions
Newest first. Read a version's tree, files, diff and zip through /v1/artifacts/{artifactId}/versions/{version}/….
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).
agentId*stringThe Agent id, percent-encoded: users%2Falice%2Ftriage for users/alice/triage
Nylorun-Protocol*stringThe protocol version, 18
Nylorun-Subject?stringThe person an application key acts for
Nylorun-Scopes?stringThe subject's space-separated scopes; required with a subject
The versions
application/json- response
agentId*stringartifactId*string|nulllatest*|0 < valueversions*array<>import { createClient } from "@nylorun/agents";const client = await createClient();const versions = await client.agents.versions("users/alice/assistant");{ "agentId": "string", "artifactId": "string", "latest": 1, "versions": [ { "version": 1, "bytes": 0, "createdAt": "string" } ]}Restore a version of an Agent's disk POST
Puts disk version `version` (or `latest`) back. A virtual Agent's workspace is rewritten at once (`done`); a pod gets a new volume seeded from the version before any turn (`pending`, with `disk.operation` in the view until it ends). The Agent keeps its id, vault and sessions. Refused during a turn or another copy (`agent_busy`).
Delete an Agent's disk version DELETE
Deletes the version, and the stored files no other version names. Refused while a seed reads it.