Skip to main content
POST
TypeScript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

namespace
string
required

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.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9_:-]+$
Example:

"user_alex"

Body

application/json
content
string
required

The content to process. This may be plaintext or a URL to supported rich content.

Example:

"Supermemory turns unstructured content into evolving memory."

id
string

An optional caller-defined document ID

Required string length: 1 - 255
Example:

"my-doc-123"

supportingContext
string

Context used to guide memory extraction within this namespace. Max 1500 characters.

Maximum string length: 1500
Example:

"Focus on product decisions, dates, and owners."

metadata
object

Arbitrary metadata attached to the document and derived data

Example:
group
object

Metadata values that isolate related context within the namespace

date
string

When the source content is from, in ISO 8601 format

Example:

"2026-01-15"

taskType
enum<string>

Processing pipeline. "memory" builds durable learned context; "superrag" optimizes the document for retrieval without generating memories.

Available options:
memory,
superrag
dreaming
enum<string>

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.

Available options:
dynamic,
instant

Response

Document accepted for processing

id
string
required

Document identifier to poll or retrieve

Minimum string length: 1
status
enum<string>
required

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

Available options:
unknown,
queued,
extracting,
chunking,
embedding,
indexing,
done,
failed