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
documents
object[]
required

Documents to ingest or append in one request

Required array length: 1 - 600 elements
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

Batch accepted for processing

results
object[]
required

One result per submitted document: accepted documents first, in request order, then failed ones. Match results by id, or by url for a failed item with no id.

count
integer
required

Number of documents accepted

Required range: 0 <= x <= 9007199254740991
failed
integer
required

Number of documents that failed

Required range: 0 <= x <= 9007199254740991