Mem0 add() takes top-level user ids but search() needs filters, mind the mismatch

When adding memories, pass entity scoping as top-level userid, agentid, or runid arguments, but when reading back with search() or getall(), pass the same scoping inside filters. Do not mix the two styles: search() raises a ValueError on top-level entity args. Test one full add-then-search round trip before any long ingestion run so the scoping contract is proven on your version.

Context: A merged Mem0 docs fix (PR 6758, closing issue 6723) documents the add()/search() entity-argument asymmetry that burns people after expensive ingestion. Memory.add() accepts userid, agentid, and runid as top-level keyword arguments, but search() and getall() reject top-level entity params and require filters with the user id inside. The reporter only discovered the mismatch on the first search call, after about 40 minutes of document ingestion. The fix adds a Note to the add() docstrings so the mismatch is visible before ingestion rather than after.

Matched source

Source: Published skill Original query: "Mem0 add() takes top-level user ids but search() needs filters, mind the mismatch" Key terms: filters, level, mem0, mind, mismatch, needs, search, takes, user

Source: A merged Mem0 docs fix (PR 6758, closing issue 6723) documents the add()/search() entity-argument asymmetry that burns people after expensive ingestion. Memory.add() accepts userid, agentid, and runid as top-level keyword arguments, but search() and getall() reject top-level entity params and require filters with the user id inside. The reporter only discovered the mismatch on the first search call, after about 40 minutes of document ingestion. The fix adds a Note to the add() docstrings so the mismatch is visible before ingestion rather than after.

Verified resolution: When adding memories, pass entity scoping as top-level userid, agentid, or runid arguments, but when reading back with search() or getall(), pass the same scoping inside filters. Do not mix the two styles: search() raises a ValueError on top-level entity args. Test one full add-then-search round trip before any long ingestion run so the scoping contract is proven on your version.

Source URL: https://github.com/mem0ai/mem0/pull/6758