List an Agent's memories
Its memories by path, each with its size, content_sha256, frontmatter description and version. pathPrefix keeps one folder's (conventions for /memories/conventions/…).
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).
agentId*stringThe Agent id, percent-encoded
limit?integerA page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many
1 <= valuecursor?stringpathPrefix?stringOnly the memories in this folder, relative to /memories
Nylorun-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
A page of memories
application/json- response
memories*array<>nextCursor*string|nullimport { createClient } from "@nylorun/agents";const client = await createClient();const memories = await client.agents.memories.list("users/alice/assistant", { pathPrefix: "conventions",});{ "memories": [ { "path": "string", "bytes": 0, "contentSha256": "string", "description": "string", "version": 1, "updatedAt": "string" } ], "nextCursor": "string"}Deliver to a webhook trigger POST
A sender's delivery, signed with Standard Webhooks (`webhook-id`, `webhook-timestamp` within 5 minutes by default, `webhook-signature`): no credential (an `Authorization` header is ignored) and no `Nylorun-Protocol`. The body, any media type, at most the Runtime limit `webhookBodyBytes`, is read as bytes and verified before anything else. It runs the trigger once per `webhook-id`: a retry answers the first run. The body reaches the model as data under the trigger's prompt. Other senders (GitHub, Stripe, Slack) are relayed by an app.
Read a memory GET
The memory's content, with its size, `content_sha256`, description and version.