Files
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
..
2025-09-28 16:42:06 -07:00
2026-01-18 16:55:32 -08:00
2025-09-28 16:42:06 -07:00
2026-01-18 16:55:32 -08:00
2025-09-28 16:42:06 -07:00
2026-01-18 16:55:32 -08:00
2026-01-18 16:55:32 -08:00
2025-10-03 02:41:49 -07:00
2025-09-28 16:42:06 -07:00
2025-09-28 16:42:06 -07:00
2026-01-18 16:55:32 -08:00
2025-09-28 16:42:06 -07:00
2025-09-28 16:42:06 -07:00
2025-10-07 17:25:39 -07:00
2025-09-28 16:42:06 -07:00
2026-04-24 23:43:16 +00:00
2026-02-04 14:56:37 -07:00
2026-01-18 16:55:32 -08:00
2026-05-06 22:42:34 -07:00
2026-01-18 16:55:32 -08:00
2025-09-28 16:42:06 -07:00
2026-01-18 16:55:32 -08:00
2026-01-18 16:55:32 -08:00
2026-02-03 00:43:08 +00:00