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.

Changes

Changed in 1 of the 2 revisions of this API.91028

Apr 27, 2026b1da2c0bb1ae91028See the full diff
- ▲
  removed ChunkingStrategy subschema #1 from the ingestion_config/anyOf[subschema #1: IngestionConfig]/chunking_strategy request property anyOf list
  request-property-any-of-removed
- ▲
  request property messages/anyOf[subschema #1]/items/role was restricted to a list of enum values
  request-property-became-enum
- ▲
  the chunks/anyOf[subschema #1]/ request property's minItems was increased to 1
  request-property-min-items-increased
- ▲
  the messages/anyOf[subschema #1]/ request property's minItems was increased to 1
  request-property-min-items-increased
- ▲
  the chunks/anyOf[subschema #1]/items/ request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the raw_text/anyOf[subschema #1]/ request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  added the pattern [\s\S]*\S[\s\S]* to the request property chunks/anyOf[subschema #1]/items/
  request-property-pattern-added
- ▲
  added the pattern [\s\S]*\S[\s\S]* to the request property raw_text/anyOf[subschema #1]/
  request-property-pattern-added
- ▲
  the ingestion_config/anyOf[subschema #1: IngestionConfig]/chunking_strategy request property type/format changed from / to string/
  request-property-type-changed
- ●
  removed the request property collection_ref
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/app
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/chunk_enrichment_settings/generation_config
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/chunks_for_document_summary
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/document_summary_max_length
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/document_summary_model
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/document_summary_system_prompt
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/document_summary_task_prompt
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/extra_fields
  request-property-removed
- ●
  removed the request property ingestion_config/anyOf[subschema #1: IngestionConfig]/skip_document_summary
  request-property-removed
- ○
  api operation id create_memory_v1_memories_post removed and replaced with create_memory
  api-operation-id-removed
- ○
  api tag Memories added
  api-tag-added
- ○
  added the new optional request property collection_id
  new-optional-request-property
- ○
  added the new optional request property content_parts
  new-optional-request-property
- ○
  added the new optional request property contents
  new-optional-request-property
- ○
  added the new optional request property messages/anyOf[subschema #1]/items/timestamp
  new-optional-request-property
- ○
  added the new optional request property snapshot
  new-optional-request-property
- ○
  added the new optional request property speaker_id
  new-optional-request-property
- ○
  added the new optional request property speaker_name
  new-optional-request-property
- ○
  the request property engram_type became optional
  request-property-became-optional
- ○
  the automatic_extraction request property default value false was added
  request-property-default-value-added
- ○
  the chunk_overlap request property default value 512 was added
  request-property-default-value-added
- ○
  the chunk_size request property default value 1024 was added
  request-property-default-value-added
- ○
  the chunking_strategy request property default value recursive was added
  request-property-default-value-added
- ○
  the engram_type request property default value document was added
  request-property-default-value-added
- ○
  the max_concurrent_vlm_tasks request property default value 5 was added
  request-property-default-value-added
- ○
  the provider request property default value nebula was added
  request-property-default-value-added
- ○
  the vlm_batch_size request property default value 5 was added
  request-property-default-value-added
- ○
  the vlm_max_tokens_to_sample request property default value 1024 was added
  request-property-default-value-added
- ○
  the vlm_ocr_one_page_per_chunk request property default value true was added
  request-property-default-value-added
- ○
  added the new assistant enum value to the request property messages/anyOf[subschema #1]/items/role
  request-property-enum-value-added
- ○
  added the new system enum value to the request property messages/anyOf[subschema #1]/items/role
  request-property-enum-value-added
- ○
  added the new user enum value to the request property messages/anyOf[subschema #1]/items/role
  request-property-enum-value-added
- ○
  request property messages/anyOf[subschema #1]/items/content list-of-types was widened by adding types array to media type application/json
  request-property-list-of-types-widened
- ○
  added NebulaResults_MemoryCreateAcceptedResponse_ NebulaResults_SnapshotMutationResult_ to the response body anyOf list for the response status 202
  response-body-any-of-added
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
- ○
  added the success response with the status 200
  response-success-status-added
This revision also has 119 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history