Skip to content

Agent Memory

Agent memory lets an agent remember information across separate conversations. Use these endpoints to read or clear stored memories.

Base URL: https://agent-api.auteryn.ai


List memories — GET /api/agents/{agent_id}/memories

Section titled “List memories — GET /api/agents/{agent_id}/memories”
Terminal window
GET https://agent-api.auteryn.ai/api/agents/{agent_id}/memories
Authorization: Bearer <jwt>
X-Agent-Id: {agent_id}

Returns memory entries extracted and stored for the agent.


Delete memories — DELETE /api/agents/{agent_id}/memories

Section titled “Delete memories — DELETE /api/agents/{agent_id}/memories”

Clears stored memory for the agent.

{
"success": true,
"deleted": 12,
"message": "Deleted 12 memory entries"
}

Knowledge retrieval (RAG) — separate endpoint

Section titled “Knowledge retrieval (RAG) — separate endpoint”

Searching attached knowledge uses a different endpoint. The knowledge collection is resolved from the X-Agent-Id header:

Terminal window
GET https://agent-api.auteryn.ai/api/retrieve?query=your+search+terms&top_k=5
Authorization: Bearer <jwt>
X-Agent-Id: your-agent-uuid
Param Description
query Search query (required)
top_k Number of chunks to return (default: 5)

To search a specific knowledge collection by ID:

Terminal window
GET https://agent-api.auteryn.ai/api/knowledge-bases/{kb_id}/retrieve?query=...

This is not the same as agent long-term memory.