mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-09-10 22:41:17 +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)_ |
||
|---|---|---|
| .. | ||
| container-tags.mdx | ||
| content-types.mdx | ||
| customization.mdx | ||
| filtering.mdx | ||
| graph-memory.mdx | ||
| how-it-works.mdx | ||
| memory-vs-rag.mdx | ||
| super-rag.mdx | ||
| user-profiles.mdx | ||