mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-11 03:37:56 +00:00
672defc08b
Rewrites 339 TypeScript calls across 50 pages from the rc.5 `method({ namespace, body })` form to the shipped `method(namespace, { ... })` form, and aligns field names with the live v5 spec: `attach` to `include`, `authUrl` to `authorization`, `lastSync` to `latestRun`, `deletedCount` to `count`, and the paginated `namespaces.list()`.
Renames container tags to namespaces across concepts, connectors, integrations and snippets. The namespace pages keep container tag in the description, search keywords and a rename note so old searches still land, and the v3 reference page points at v5.
The migration guide's SDK table now covers both 5.0.0 SDKs, and the SDK integration page uses the real client options (`baseUrl`, `timeoutInSeconds`, `maxRetries`) and error classes.
42 lines
1.5 KiB
Text
42 lines
1.5 KiB
Text
---
|
|
title: "Namespaces"
|
|
sidebarTitle: "Overview"
|
|
description: "Keep memory isolated, understandable, and easy to reorganize"
|
|
icon: "/icons/hugeicons/book-open-01.svg"
|
|
keywords: ["container tag", "container tags", "containerTag", "namespace"]
|
|
---
|
|
|
|
<Note>
|
|
Namespaces were called **container tags** (`containerTag`) in v3 and v4. Same values, nothing moved.
|
|
</Note>
|
|
|
|
| Operation | Purpose |
|
|
| --- | --- |
|
|
| `GET /namespaces` | Discover namespaces and see their memory footprint |
|
|
| `GET /ns/{namespace}` | See the context guiding one namespace |
|
|
| `PATCH /ns/{namespace}` | Give Supermemory better context for future memories |
|
|
| `DELETE /ns/{namespace}` | Retire a namespace or preserve its content elsewhere |
|
|
|
|
<CodeGroup>
|
|
```ts TypeScript
|
|
const { namespaces } = await supermemory.namespaces.list()
|
|
|
|
await supermemory.namespaces.update("project_alpha", {
|
|
supportingContext: "Research project for distributed systems",
|
|
})
|
|
```
|
|
|
|
```bash curl
|
|
curl "https://api.supermemory.ai/namespaces" \
|
|
-H "Authorization: Bearer $SUPERMEMORY_API_KEY"
|
|
|
|
curl -X PATCH "https://api.supermemory.ai/ns/project_alpha" \
|
|
-H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"supportingContext":"Research project for distributed systems"}'
|
|
```
|
|
</CodeGroup>
|
|
|
|
`GET /ns` is an alias for `GET /namespaces`. Profile buckets are managed through `/ns/{namespace}/profile/buckets`, not namespace settings.
|
|
|
|
See [namespace and settings migration](/migration/api-v5-settings).
|