NylorunDocsBeta
Runtime APIAgentsMemory

Delete a memory or a folder

DELETE
/v1/agents/{agentId}/memories/{path}

Deletes the memory, or every memory in the folder the path names, each with a version that records the delete. Versions stay with the Agent.

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

path*string

The memory's path under /memories, percent-encoded: conventions%2Frelease.md is /memories/conventions/release.md

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

What was deleted

application/json
  1. response
path*string
deleted*integer
Range0 <= value
import { createClient } from "@nylorun/agents";const client = await createClient();await client.agents.memories.delete("users/alice/assistant", "conventions/release.md");
{  "path": "string",  "deleted": 0}