Memories

Manage agent memories. Actions: “save” (create new), “list” (search/filter), “update” (modify existing), “delete” (remove).

Input Schema

Parameter	Type	Description
action	string	Action to perform on memories. Enum: save, list, update, delete
content	string	The content to save or update. Required for “save”, optional for “update”.
key	string	Optional categorization key (e.g. “user_preferences”). used in save/update.
memory_id	string	The ID of the memory to update or delete. Required for “update” and “delete” actions.
search_query	string	Optional search term to filter memories (searches in content, summary, and key).
type	string	Optional memory type filter. Default is “assistant_note”.
limit	number	Maximum number of memories to return. Default 10.
client_id	string	Optional. Scope to a specific client.
project_id	string	Optional. Scope to a specific project.
task_id	string	Optional. Scope to a specific task.

REST Endpoint

Actions map to sub-routes: save → /save, list → /get, update → /update, delete → /delete.


POST /api/agents/tools/memories/save
POST /api/agents/tools/memories/get
POST /api/agents/tools/memories/update
POST /api/agents/tools/memories/delete


POST /api/agents/tools/memories/save
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "content": "User prefers formal communication style",
  "key": "user_preferences",
  "type": "assistant_note"
}

Response:


{
  "success": true,
  "memory": { "id": "...", "key": "user_preferences" }
}