Skip to main content

save_memory

Save important information to workspace memory. Memories persist across all conversations in the workspace and can be retrieved later using get_memories.

Use Cases

  • Store user preferences and decisions
  • Remember important facts or patterns
  • Save context that should persist across conversations
  • Track agent-specific information

Parameters

string
required
The memory content to save. This should be clear, concise, and self-contained.
string
Optional identifier for the agent saving this memory. Useful for tracking which agent created the memory.
string
Optional human-readable name for the agent. Helps identify the source of the memory.

Response

boolean
Whether the operation succeeded
string
UUID of the created memory
string
Success message with preview of saved content

Example Request

Example Response

Behavior

  • Memories are automatically indexed in ChromaDB for semantic search
  • Each memory is associated with the API key that created it
  • Memories are scoped to the project associated with the API key
  • Content is trimmed of leading/trailing whitespace before saving

Error Handling

Best Practices

  1. Be specific: Include enough context for the memory to be useful later
  2. Keep it concise: Focus on key information, not full conversation history
  3. Use agent metadata: Include agent_id and agent_name when relevant
  4. Save proactively: Store important information as soon as you learn it