mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-11 03:37:56 +00:00
3535ff700d
Some checks failed
Publish Agent Framework Python / publish (push) Has been cancelled
Publish AI SDK / publish (push) Has been cancelled
Publish Cartesia SDK Python / publish (push) Has been cancelled
Publish OpenAI SDK Python / publish (push) Has been cancelled
Publish Pipecat SDK Python / publish (push) Has been cancelled
Publish Tools / publish (push) Has been cancelled
New shared snippet with the npx supermemory@latest migrate command, placed on the tools 3.0 guide, the four integration pages, the API reference overview and namespaces page, the ten migration sub pages, and the agents page. The migration guide keeps the command first and folds the paste-in prompt into an accordion; the --prompt variant is gone from the examples.
46 lines
1.6 KiB
Text
46 lines
1.6 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"]
|
|
---
|
|
|
|
import MigrateCli from "/snippets/migrate-cli.mdx";
|
|
|
|
<Note>
|
|
Namespaces were called **container tags** (`containerTag`) in v3 and v4. Same values, nothing moved.
|
|
</Note>
|
|
|
|
<MigrateCli legacy="v3 or v4" guideHref="/migration/api-v5" guideLabel="v5 migration guide" />
|
|
|
|
| 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).
|