Memory Operations

Advanced memory operations (v4 API)

These v4 endpoints operate on extracted memories (not raw documents). SDK support coming soon — use fetch or cURL for now.

For document management (list, get, update, delete), see Document Operations.

Forget Memory

Soft-delete a memory — excluded from search results but preserved in the system. Use this when you might want to restore later.

fetch

await fetch("https://api.supermemory.ai/v4/memories/mem_abc123/forget", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`
  }
});

cURL

curl -X POST "https://api.supermemory.ai/v4/memories/mem_abc123/forget" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY"

The memory will no longer appear in search results but remains in the database.

---

Update Memory (Versioned)

Update a memory by creating a new version. The original is preserved with isLatest=false.

fetch

await fetch("https://api.supermemory.ai/v4/memories", {
  method: "PATCH",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // Identify by ID or content
    id: "mem_abc123",
    // content: "Original content to match",

    newContent: "Updated content goes here",
    metadata: {
      tags: ["updated"]
    }
  })
});

cURL

curl -X PATCH "https://api.supermemory.ai/v4/memories" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "mem_abc123",
    "newContent": "Updated content goes here",
    "metadata": {"tags": ["updated"]}
  }'

Parameters

Parameter	Type	Required	Description
id	string	*	Memory ID to update
content	string	*	Original content to match (alternative to ID)
newContent	string	yes	New content for the memory
metadata	object	no	Updated metadata

* Either id or content must be provided.

---

Next Steps

• Document Operations — Manage documents (SDK supported)
• Search — Query your memories
• Ingesting Content — Add new content