List sessions
Acting for a person, only theirs.
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?integerA page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many
1 <= valuecursor?stringagentId?stringstatus?string"idle""runnable""running""waiting""paused""uncertain""completed""failed""cancelled"manifest?stringownerUserId?stringNylorun-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 sessions; limit opts into pagination
application/json- response
sessions*array<>import { createClient } from "@nylorun/agents";const client = await createClient();const page = await client.sessions.page({ manifest: "assistant", limit: 20 });{ "sessions": [ { "id": "string", "agentId": "string", "ownerUserId": "string", "status": "idle", "activeTurnId": "string" } ]}Get a session GET
Previous Page
Send a command to a session POST
A message starts a turn, or waits in the session's queue while a turn runs or waits (protocol 17; `delivery: "reject"` is refused with `409 session_busy` instead); the others answer what the session waits on, or cancel. Idempotent on the command's `idempotencyKey`.