API ReferenceAgent API

Memories

🔒 Enterprise

Memory API endpoints require an enterprise plan.

Store and retrieve agent memories for persistent knowledge across sessions. Memories let agents retain information between conversations without external storage.

MethodPathDescription
GET/api/v1/agent/memoriesList memories
POST/api/v1/agent/memoriesStore a memory
GET/api/v1/agent/memories/{id}Get a specific memory
POST/api/v1/agent/memories/{id}/archiveArchive a memory
POST/api/v1/agent/memories/{id}/supersedeReplace a memory with an updated version

Key concepts

  • Memories persist across sessions, no external database needed
  • Supersede creates a new memory linked to the original, maintaining a revision chain
  • Archived memories are hidden from default listing but not deleted
Context

Session-scoped conversation history

Identity

Verify your agent first