Sign in

v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-272589173.5 KB
Memories

Create a new memory (conversation or document)

Create a new memory (conversation or document) using clean JSON body.

  • Use collection_id (UUID)
  • engram_type is optional and inferred from payload shape:
    • If messages present -> conversation
    • Otherwise -> document
  • For conversations: provide messages array
  • For documents: provide raw_text or chunks
  • Use snapshot for device-memory mode (mutually exclusive with collection_id)
post/v1/memories

Request body

chunksstring[] nullable

Pre-chunked text for document type

collection_idstring uuid nullable

Collection UUID (mutually exclusive with snapshot)

contentsstring[] nullable

Batch content strings for snapshot mode

engram_type'document' | 'conversation'

Type of memory to create

ingestion_mode'hi-res' | 'ocr' | 'fast' | 'custom'
metadataobject nullable

Metadata for the memory

namestring nullable

Optional name for the memory

raw_textstring nullable

Raw text content for document type

speaker_idstring uuid nullable

UUID of the SourceRole entity creating this memory

speaker_namestring nullable

Display name of the speaker/agent creating this memory

Response

Snapshot mode returns an updated SnapshotEnvelope synchronously.

OR