Batch Operations

Batch Delete

POST/agent/memory/delete/batch

Delete multiple memories by their IDs in a single request. Removes vector embeddings and knowledge graph entries for each memory.

Headers

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

Body Parameters

memory_idsstring[] (UUIDs)required

Array of memory IDs to delete. Maximum 100 per request.

Response

200 Batch delete completed

{
  "success": true,
  "deleted": 5,
  "failed": 0,
  "results": [
    { "memory_id": "a1b2c3d4-...", "success": true },
    { "memory_id": "e5f6a7b8-...", "success": true }
  ]
}

---

Batch Update

POST/agent/memory/update/batch

Update multiple memories in a single request.

Headers

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

Body Parameters

updatesobject[]required

Array of update objects. Maximum 100 per request. Each object must include:

Field	Type	Required	Description
memory_id	string (UUID)	yes	ID of the memory to update
content	string	no	New content for the memory
metadata	object	no	Updated metadata key-value pairs

Response

200 Batch update completed

{
  "success": true,
  "updated": 3,
  "failed": 0,
  "results": [
    { "memory_id": "a1b2c3d4-...", "success": true },
    { "memory_id": "e5f6a7b8-...", "success": true }
  ]
}