NylorunDocsBeta
Runtime APISessions

Page a session's tool calls

GET
/v1/sessions/{sessionId}/calls/tool

Authorization

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

Path Parameters

sessionId*string

Query Parameters

turnId?string
limit?integer

A page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many. Default 50, or that limit when it is lower

Range1 <= value
cursor?string

Header Parameters

Nylorun-Protocol*string

The protocol version, 18

Response Body

Each tool call in the order it was first sent, with its status and sends

application/json
  1. response
calls*array<>
nextCursor*string|null
asOf*string
import { createClient } from "@nylorun/agents";const client = await createClient();const calls = await client.session("ses_123").toolCalls({ limit: 50 });
{  "calls": [    {      "effectId": "string",      "turnId": "string",      "callId": "string",      "toolName": "string",      "kind": "mcp",      "server": "string",      "tool": "string",      "skill": "string",      "plugin": {        "name": "string",        "version": "string"      },      "status": "invoking",      "attempts": 0,      "input": null,      "error": {        "code": "string",        "message": "string"      },      "startedAt": "string",      "settledAt": "string",      "durationMs": 0    }  ],  "nextCursor": "string",  "asOf": "string"}