Namespaces

Namespaces were called container tags (containerTag) in v3 and v4. Same values, nothing moved.

On v3 or v4? Run npx supermemory@latest migrate, or read the 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

const { namespaces } = await supermemory.namespaces.list()

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

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"}'

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.

Ingest

Content Management

Search

Profiles

Connectors

Organization

Feedback

Namespaces