supermemory/apps/docs
vorflux 1f2b5dfca2 docs: add filtered writes documentation (#834)
### TL;DR

Documents the new `filterByMetadata` parameter for the memory ingestion API, added in [supermemoryai/mono#1283](https://github.com/supermemoryai/mono/pull/1283).

### What changed?

- Added a new "Filtered Writes" section to the `add-memories.mdx` page explaining how to scope memory context during ingestion
- Added `filterByMetadata` to the Parameters table with a link to the new section
- Included TypeScript, Python, and cURL examples
- Documented scalar vs array value matching semantics (AND/OR logic)

### Key documentation points

- The metadata itself is still written to the document, but memories are only built on top of existing memories matching the filter
- Scalar values match exactly, array values create OR conditions
- Multiple keys are combined with AND logic

### Related

- Implementation PR: [supermemoryai/mono#1283](https://github.com/supermemoryai/mono/pull/1283)

---
**Session Details**
- Session: [View Session](https://supermemory.us1.vorflux.com/agent-sessions/14d33783-50b0-4fc8-8e0f-abc6346336f1)
- Requested by: Dhravya Shah (dhravya@supermemory.com)
- Address comments on this PR. Add `(aside)` to your comment to have me ignore it.
2026-05-15 14:53:54 +00:00
..
.cursor/rules migrate docs to public 2025-09-28 16:42:06 -07:00
add-memories docs: clarify metadata-only PATCH does not reindex (#784) 2026-03-17 20:48:52 +00:00
ai-sdk docs: @supermemory/tools v2.0.0 & migration guide (#886) 2026-04-27 18:24:59 +00:00
changelog docs: google drive connector scoped sync and changelog (#857) 2026-04-16 16:01:51 -07:00
concepts docs: add entity context documentation and fix MDX parsing (#723) 2026-02-03 22:53:21 +00:00
connectors docs: fix s3 connector config shape (#941) 2026-05-13 12:40:22 -07:00
cookbook docs changes (#678) 2026-01-18 16:55:32 -08:00
deployment migrate docs to public 2025-09-28 16:42:06 -07:00
images feat: mcp modal with better instructions (#836) 2026-04-08 19:20:11 +00:00
integrations convex integration with supermemory (#880) 2026-05-11 10:59:14 -07:00
list-memories docs changes (#678) 2026-01-18 16:55:32 -08:00
logo migrate docs to public 2025-09-28 16:42:06 -07:00
memory-api docs: clarity on document limit for connectors (#841) 2026-04-09 15:17:49 +00:00
memory-graph docs changes (#678) 2026-01-18 16:55:32 -08:00
memory-router docs changes (#678) 2026-01-18 16:55:32 -08:00
memorybench Add MemScore documentation to memorybench docs (#797) 2026-03-23 15:19:40 -07:00
migration docs: @supermemory/tools v2.0.0 & migration guide (#886) 2026-04-27 18:24:59 +00:00
model-enhancement fix: model names 2025-10-03 02:41:49 -07:00
openai-sdks migrate docs to public 2025-09-28 16:42:06 -07:00
overview migrate docs to public 2025-09-28 16:42:06 -07:00
search docs changes (#678) 2026-01-18 16:55:32 -08:00
smfs docs: SMFS documentation — providers, Python bash tool, examples (#889) 2026-04-28 20:04:15 -07:00
snippets migrate docs to public 2025-09-28 16:42:06 -07:00
supermemory-mcp feat: mcp modal with better instructions (#836) 2026-04-08 19:20:11 +00:00
update-delete-memories docs: clarify metadata-only PATCH does not reindex (#784) 2026-03-17 20:48:52 +00:00
user-profiles custom id implementation (#877) 2026-04-24 23:43:16 +00:00
.gitignore migrate docs to public 2025-09-28 16:42:06 -07:00
add-memories.mdx docs: add filtered writes documentation (#834) 2026-05-15 14:53:54 +00:00
analytics.mdx fix: all broken links 2025-10-07 17:25:39 -07:00
authentication.mdx docs: add scoped key deletion endpoint to auth docs (#756) 2026-02-28 01:06:12 +00:00
docs.json convex integration with supermemory (#880) 2026-05-11 10:59:14 -07:00
document-operations.mdx docs: clarify metadata-only PATCH does not reindex (#784) 2026-03-17 20:48:52 +00:00
favicon.png migrate docs to public 2025-09-28 16:42:06 -07:00
install.md custom id implementation (#877) 2026-04-24 23:43:16 +00:00
intro.mdx trigger: Mintlify build (#725) 2026-02-04 14:56:37 -07:00
introduction.mdx docs changes (#678) 2026-01-18 16:55:32 -08:00
memory-operations.mdx direct add memory support 2026-02-09 18:32:24 -08:00
n8n.mdx add(docs): migration guide from zep to supermemory (#612) 2025-12-20 00:47:52 +00:00
package.json use portless 2026-05-06 22:42:34 -07:00
quickstart.mdx docs changes (#678) 2026-01-18 16:55:32 -08:00
README.md migrate docs to public 2025-09-28 16:42:06 -07:00
search.mdx docs changes (#678) 2026-01-18 16:55:32 -08:00
style.css feat: mobile responsive, lint formats, toast, render issue fix (#688) 2026-01-21 03:11:53 +00:00
test.py docs changes (#678) 2026-01-18 16:55:32 -08:00
test.ts mastra integration (#717) 2026-02-03 00:43:08 +00:00
user-profiles.mdx custom id implementation (#877) 2026-04-24 23:43:16 +00:00
vibe-coding.mdx custom id implementation (#877) 2026-04-24 23:43:16 +00:00
zapier.mdx add(docs): migration guide from zep to supermemory (#612) 2025-12-20 00:47:52 +00:00

supermemory Docs