API reference - supermemory | Memory API for the AI era

v5 makes namespace scope explicit in the URL and consolidates overlapping legacy operations.

https://api.supermemory.ai
  /ns/{namespace}/document
  /ns/{namespace}/search
  /ns/{namespace}/profile
  /ns/{namespace}/list/{type}
  /ns/{namespace}/memories
  /namespaces
  /organization

Use the v5 reference for the stable v5 API. /reference always points to the latest public version.

Install the TypeScript SDK

npm i supermemory

import { Supermemory } from "supermemory"

const supermemory = new Supermemory({ apiKey: process.env.SUPERMEMORY_API_KEY })

Every SDK call takes one object. namespace, path IDs, and query parameters are top-level keys; the JSON body goes under body. Each reference page below shows the SDK call next to the equivalent curl. There is no v5 Python SDK yet.

Migrate to v5

Translate every v3/v4 request and response deterministically.

Authentication

Authenticate with the same bearer API keys used by legacy endpoints.