NylorunDocsBeta
Runtime APISessions

List sessions

GET
/v1/sessions

Acting for a person, only theirs.

Authorization

headerAuthorizationBearer <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).

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
agentId?string
status?string
Value in"idle""runnable""running""waiting""paused""uncertain""completed""failed""cancelled"
sandboxId?string
ownerUserId?string

Header Parameters

Nylorun-Protocol*string

The protocol version, 8

Nylorun-Subject?string

The person an application key acts for

Nylorun-Scopes?string

The subject's space-separated scopes; required with a subject

Response Body

The sessions; limit opts into pagination

application/json
  1. response
sessions*array<>
import { createClient } from "@nylorun/agents";const client = await createClient();const page = await client.sessions.page({ agentId: "assistant", limit: 20 });
{  "sessions": [    {      "id": "string",      "agentId": "string",      "ownerUserId": "string",      "status": "idle",      "activeTurnId": "string"    }  ]}