> ## 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

<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 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.