Get the Runtime API's document
curl -X GET "https://example.com/openapi/runtime.json"Get the public keys the Runtime's tokens are signed with GET
A JSON Web Key Set, to verify a token the Runtime signed without calling it. No credential is needed.
Create, find or move an Agent PUT
Creates the Agent, its vault and its compute from a saved agent manifest, within the Tenant's limits, or answers the one with this id, so get-or-create is one call. `manifest: "name"` records that it tracks the manifest (its latest version, and each version saved later) and `"name@n"` that it is pinned; the version it runs is `resolvedVersion`. On an existing one, labels replace, `owner` sets or (with `null`) clears the owner guard, and `manifest` moves it with its id, disk, vault and sessions: a harness-only change applies at once (each session's next turn runs it), a runtime change of a pod at its next start (`targetVersion`, `waitingFor: start`), and a version that adds a required secret once a value is set (`waitingFor: secrets`). Its manifest's name, kind, harness and storage are fixed (`409 agent_fixed_field`): fork it to change them. One kind change is not: on a Runtime whose pods are computers, a `PUT` that moves a `virtual` Agent to a `pod` version makes it a computer in place (ADR-154), keeping its id, sessions, memory, vault, triggers, events and labels; `from` then seeds its new volume from a disk version of another Agent with the same owner, its virtual workspace is deleted, and `agent.version_changed` records `kindFrom` and `kindTo`. A manifest save never does: a tracking Agent stays on its version. `?dryRun=true` answers the move's plan and changes nothing. Creating an Agent opens no session. Kind `pod` needs sandbox pods (`nylorun local sandbox enable`) and is created at once.