mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-09-09 22:31:10 +00:00
2e0043dbe4
## What & why The Mintlify docs app didn't have a dedicated page explaining **container tags** — the core concept used everywhere in the Supermemory API. Container tags were only mentioned in passing inside `concepts/filtering.mdx`, so there was no single place a developer could go to understand what they are and how they behave. This PR adds a `Container Tags` concept page, derived from how the `mono` API actually implements them. ## What the page covers - **The isolation/namespacing model** — each container tag maps to its own vector namespace (`memoryNamespace` / `chunkNamespace` in `apps/api/src/services/vectordb/namespace.ts`), so retrieval never leaks across tags. - **Auto-creation** — adding a memory with a new tag auto-creates the backing `space` (upsert on `(container_tag, org_id)`). - **Naming rules** — `≤ 100` chars, pattern `^[a-zA-Z0-9_:-]+$`, taken straight from `containerTagValidator` in `packages/validation/api.ts`. Notes the colon for hierarchical tags. - **`containerTag` (current) vs `containerTags` (deprecated array)** — matches the deprecation in the validation schemas and the `/v4` API. - **Lifecycle usage** — add / search / list / update / delete. - **Access control** — API key scopes + member container-tag restrictions, and the `403` behavior enforced by `containerTagGate` / `containerTagGuard` (`apps/api/src/lib/auth/container-tag-guard.ts`). - **Per-container settings** — `name` and `entityContext`, plus merge, from `ContainerTagSettingsSchema`. - **Recommended naming conventions** — user / project / agent / hierarchical patterns. ## Changes - Add `apps/docs/concepts/container-tags.mdx` - Register the page in `apps/docs/docs.json` under the **Concepts** group (before `concepts/filtering`) ## Notes - Opened as a **draft** for review. - Validated `docs.json` remains well-formed JSON. - The existing `concepts/filtering.mdx` is cross-linked rather than duplicated — it keeps the filter-combination examples; this page focuses on the concept itself. https://claude.ai/code/session_01Xwp8sDZrsQr5mmuRu5TYvX --- _Generated by [Claude Code](https://claude.ai/code/session_01Xwp8sDZrsQr5mmuRu5TYvX)_ |
||
|---|---|---|
| .. | ||
| .cursor/rules | ||
| add-memories | ||
| ai-sdk | ||
| changelog | ||
| concepts | ||
| connectors | ||
| cookbook | ||
| images | ||
| integrations | ||
| list-memories | ||
| logo | ||
| memory-api | ||
| memory-graph | ||
| memory-router | ||
| memorybench | ||
| migration | ||
| model-enhancement | ||
| openai-sdks | ||
| overview | ||
| search | ||
| self-hosting | ||
| smfs | ||
| snippets | ||
| supermemory-mcp | ||
| update-delete-memories | ||
| user-profiles | ||
| .gitignore | ||
| add-memories.mdx | ||
| analytics.mdx | ||
| authentication.mdx | ||
| docs.json | ||
| document-operations.mdx | ||
| favicon.png | ||
| install.md | ||
| intro.mdx | ||
| introduction.mdx | ||
| memory-operations.mdx | ||
| n8n.mdx | ||
| package.json | ||
| quickstart.mdx | ||
| README.md | ||
| search.mdx | ||
| style.css | ||
| test.py | ||
| test.ts | ||
| user-profiles.mdx | ||
| vibe-coding.mdx | ||
| zapier.mdx | ||
