memory.add
Saves a new memory with automatic embedding generation for semantic search.
Parameters
Response
Examples
Embedding Generation
When you save a memory, Satori automatically:- Sends the content to OpenAI’s
text-embedding-3-smallmodel - Receives a 1536-dimensional vector
- Stores both the text and embedding in PostgreSQL
Embedding generation typically takes 50-100ms. The API call returns after the memory is fully saved with its embedding.
Best Practices
Write complete, self-contained memories
Write complete, self-contained memories
Use metadata for organization
Use metadata for organization
Avoid duplicate memories
Avoid duplicate memories
Error Handling
Related Endpoints
Search Memories
Find relevant memories using semantic search
Get All Memories
Retrieve all memories for a user
Delete Memory
Remove a specific memory
Integration Guide
See this endpoint in action