NylorunDocsBeta
Runtime APIAgentsMemory

List an Agent's memory versions

GET
/v1/agents/{agentId}/memory_versions

Every change to its memories, newest first: the operation, the path (a rename's names its old one), and who made it: agent:<manifest>@<version> with the session, turn and trigger run of a turn's write, or the API caller. path keeps one memory's.

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

Path Parameters

agentId*string

The Agent id, percent-encoded

Query Parameters

limit?integer

A page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many

Range1 <= value
cursor?string
path?string

Only this memory's versions, relative to /memories

Header Parameters

Nylorun-Protocol*string

The protocol version, 18

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

A page of versions

application/json
  1. response
versions*array<>
nextCursor*string|null
import { createClient } from "@nylorun/agents";const client = await createClient();const versions = await client.agents.memories.versions("users/alice/assistant", {  path: "conventions/release.md",});
{  "versions": [    {      "id": "string",      "path": "string",      "fromPath": "string",      "operation": "create",      "bytes": 0,      "contentSha256": "string",      "actor": "string",      "sessionId": "string",      "turnId": "string",      "triggerRunId": "string",      "createdAt": "string"    }  ],  "nextCursor": "string"}