Skip to main content

Store multiple memories asynchronously

POST 
/api/v1/memory banks/:agent_id/memories/async

Store multiple memory items in batch asynchronously using the task backend.

This endpoint returns immediately after queuing the task, without waiting for completion. The actual processing happens in the background.

Features:

  • Immediate response (non-blocking)
  • Background processing via task queue
  • Efficient batch processing
  • Automatic fact extraction from natural language
  • Entity recognition and linking
  • Document tracking with automatic upsert (when document_id is provided)
  • Temporal and semantic linking

The system automatically:

  1. Queues the batch put task
  2. Returns immediately with success=True, queued=True
  3. Processes in background: extracts facts, generates embeddings, creates links

Note: If document_id is provided and already exists, the old document and its memory units will be deleted before creating new ones (upsert behavior).

Request​

Responses​

Successful Response