From 49061718bd244ee227e55456b3a93b61c3a19e0a Mon Sep 17 00:00:00 2001
From: Kartik <kartik.labhshetwar@mem0.ai>
Date: Sat, 27 Jun 2026 18:41:35 +0530
Subject: [PATCH] docs(cookbooks): fix v3 filters & update() in
 companions/essentials (#5844)

---
 .../cookbooks/companions/nodejs-companion.mdx |  2 +-
 .../essentials/building-ai-companion.mdx      | 21 +++++++------------
 .../essentials/exporting-memories.mdx         |  1 +
 3 files changed, 9 insertions(+), 15 deletions(-)

diff --git a/docs/cookbooks/companions/nodejs-companion.mdx b/docs/cookbooks/companions/nodejs-companion.mdx
index 6b5afa221..d85f26cb0 100644
--- a/docs/cookbooks/companions/nodejs-companion.mdx
+++ b/docs/cookbooks/companions/nodejs-companion.mdx
@@ -31,7 +31,7 @@ const openaiClient = new OpenAI();
 const memory = new Memory();
 
 async function chatWithMemories(message, userId = "default_user") {
-  const relevantMemories = await memory.search(message, { userId: userId });
+  const relevantMemories = await memory.search(message, { filters: { user_id: userId } });
   
   const memoriesStr = relevantMemories.results
     .map(entry => `- ${entry.memory}`)
diff --git a/docs/cookbooks/essentials/building-ai-companion.mdx b/docs/cookbooks/essentials/building-ai-companion.mdx
index 550e72a46..602f04fd3 100644
--- a/docs/cookbooks/essentials/building-ai-companion.mdx
+++ b/docs/cookbooks/essentials/building-ai-companion.mdx
@@ -289,8 +289,7 @@ print([m["memory"] for m in constraints["results"]])
 ```python
 constraints = memory.search(
     query="injury concerns",
-    user_id="max",
-    filters={"memory_bucket": {"in": ["constraints"]}},
+    filters={"user_id": "max", "memory_bucket": {"in": ["constraints"]}},
     threshold=0.0  # optional: widen recall for short phrases
 )
 print([m["memory"] for m in constraints["results"]])
@@ -736,8 +735,7 @@ mem0_client.add(messages, user_id="max", run_id="nyc-2025")
 # Retrieve only Boston memories
 boston_memories = mem0_client.search(
     "training plan",
-    user_id="max",
-    run_id="boston-2025"
+    filters={"user_id": "max", "run_id": "boston-2025"}
 )
 ```
   </Tab>
@@ -749,8 +747,7 @@ memory.add(messages, user_id="max", run_id="nyc-2025")
 # Retrieve only Boston memories
 boston_memories = memory.search(
     "training plan",
-    user_id="max",
-    run_id="boston-2025",
+    filters={"user_id": "max", "run_id": "boston-2025"},
 )
 ```
   </Tab>
@@ -846,8 +843,7 @@ Prioritize recent training over old data:
 ```python
 recent = mem0_client.search(
     "training progress",
-    user_id="max",
-    filters={"created_at": {"gte": "2025-10-01"}}
+    filters={"user_id": "max", "created_at": {"gte": "2025-10-01"}}
 )
 ```
   </Tab>
@@ -866,8 +862,7 @@ memory.add(
 cutoff = int(datetime(2025, 10, 1).timestamp())
 recent = memory.search(
     "training progress",
-    user_id="max",
-    filters={"logged_epoch": {"gte": cutoff}},
+    filters={"user_id": "max", "logged_epoch": {"gte": cutoff}},
 )
 ```
   </Tab>
@@ -889,8 +884,7 @@ mem0_client.add(
 # Later, find all speed workouts
 speed_sessions = mem0_client.search(
     "speed work",
-    user_id="max",
-    filters={"metadata": {"workout_type": "speed"}}
+    filters={"user_id": "max", "metadata": {"workout_type": "speed"}}
 )
 ```
   </Tab>
@@ -905,8 +899,7 @@ memory.add(
 # Later, find all speed workouts
 speed_sessions = memory.search(
     "speed work",
-    user_id="max",
-    filters={"workout_type": "speed"},
+    filters={"user_id": "max", "workout_type": "speed"},
 )
 ```
   </Tab>
diff --git a/docs/cookbooks/essentials/exporting-memories.mdx b/docs/cookbooks/essentials/exporting-memories.mdx
index 229406655..7f1ea547d 100644
--- a/docs/cookbooks/essentials/exporting-memories.mdx
+++ b/docs/cookbooks/essentials/exporting-memories.mdx
@@ -58,6 +58,7 @@ Use `get_all()` with filters to retrieve everything for a specific user:
 ```python
 dev_memories = client.get_all(
     filters={"user_id": "dev"},
+    page=1,
     page_size=50
 )