Add document
Turn text or a supported URL into searchable, evolving memory. Supply a new ID to create a document, or reuse an existing ID to append new information while preserving its history.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The isolated namespace. This can be an ID for your user, a project ID, or any other identifier you wish to use to scope documents.
100^[a-zA-Z0-9_:-]+$"user_alex"
Body
The content to process. This may be plaintext or a URL to supported rich content.
"Supermemory turns unstructured content into evolving memory."
An optional caller-defined document ID
1 - 255"my-doc-123"
Context used to guide memory extraction within this namespace. Max 1500 characters.
1500"Focus on product decisions, dates, and owners."
Arbitrary metadata attached to the document and derived data
Metadata values that isolate related context within the namespace
When the source content is from, in ISO 8601 format
"2026-01-15"
Processing pipeline. "memory" builds durable learned context; "superrag" optimizes the document for retrieval without generating memories.
memory, superrag Processing mode. "dynamic" (default) groups related documents so memories form from coherent context. "instant" processes each document independently right away and bills one extra operation per document.
dynamic, instant Response
Document accepted for processing
Document identifier to poll or retrieve
1The document's processing state after this request. queued when new work was queued; otherwise its current state, e.g. done for an unchanged duplicate or failed for a metadata-only update to a failed document.
unknown, queued, extracting, chunking, embedding, indexing, done, failed