Manage Memory

Get Memory

GET/agent/memory/:memoryId

Retrieve a single memory by its ID.

Headers

Header	Value
Authorization	Bearer sm_agent_...

Path Parameters

Parameter	Type	Description
memoryId	string (UUID)	The memory ID to retrieve

Response

200 Memory found

{
  "id": "a1b2c3d4-...",
  "content": "User prefers dark mode",
  "memory_type": "preference",
  "score": 0.92,
  "created_at": "2026-04-18T12:00:00Z",
  "volume_id": "...",
  "metadata": {}
}

---

Update Memory

PATCH/agent/memory/:memoryId

Update a memory's content or metadata.

Headers

Header	Value
Authorization	Bearer sm_agent_...
Content-Type	application/json

Path Parameters

Parameter	Type	Description
memoryId	string (UUID)	The memory ID to update

Body Parameters

contentstring

New content for the memory.

metadataobject

Updated metadata key-value pairs.

Response

200 Memory updated

{
  "success": true,
  "memory_id": "a1b2c3d4-..."
}

---

Delete Memory

DELETE/agent/memory/:memoryId

Permanently delete a memory, including its vector embedding and knowledge graph entries.

Headers

Header	Value
Authorization	Bearer sm_agent_...

Path Parameters

Parameter	Type	Description
memoryId	string (UUID)	The memory ID to delete

Response

200 Memory deleted

{
  "success": true,
  "memory_id": "a1b2c3d4-..."
}