Search Documentation
Search across all documentation pages
update_memory
Update an existing memory's content, summary, type, importance, confidence, entities, or other fields. Re-encrypts and re-indexes embeddings when content changes. All update fields are optional — only provided fields are modified.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| memoryId | string (UUID) | required | The memory ID to update |
| content | string (1-1,000,000 chars) | optional | New content (replaces existing) |
| summary | string (max 500) | optional | New summary (empty string to clear) |
| memoryType | string | optional | New memory type: fact, skill, preference, constraint, task, episodic, correction |
| importance | integer (1-5) | optional | New importance (1-5) |
| confidence | integer (1-5) | optional | New confidence (1-5) |
| entities | string[] | optional | New entities (replaces existing) |
| relatedMemoryIds | array | optional | New related memories (replaces existing). Each object: { memoryId: uuid, relationType: "derived_from" | "contradicts" | "refines" | "part_of" | "supersedes" } |
| sourceNoteIds | string[] (UUIDs) | optional | New source note IDs (replaces existing) |
| isArchived | boolean | optional | Archive or unarchive |
| metadata | object | optional | Metadata fields to merge (not replace). For tasks: { taskStatus: "in_progress", assignedAgentId: "claude_code" } |
Returns#
Confirmation of the update with the memory ID and updated fields.
Example#
json
{
"tool": "update_memory",
"arguments": {
"memoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"importance": 5,
"entities": ["PostgreSQL", "infrastructure"],
"metadata": {
"taskStatus": "done"
}
}
}