> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Namespaces

> Keep memory isolated, understandable, and easy to reorganize

export const legacy_0 = "v3 or v4"

export const guideHref_0 = "/migration/api-v5"

export const guideLabel_0 = "v5 migration guide"

<Note>
  Namespaces were called **container tags** (`containerTag`) in v3 and v4. Same values, nothing moved.
</Note>

<Tip>
  On {legacy_0}? Run `npx supermemory@latest migrate`, or read the <a href={guideHref_0}>{guideLabel_0}</a>.
</Tip>

| 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 theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  const { namespaces } = await supermemory.namespaces.list()

  await supermemory.namespaces.update("project_alpha", {
    supportingContext: "Research project for distributed systems",
  })
  ```

  ```bash curl theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  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](/docs/migration/api-v5-settings).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.