Skip to main content
Ingest multiple documents in a single call. This is the primary method for bootstrap ingestion: loading historical conversations, backfilling knowledge bases, and migrating data from other systems. Each document is processed independently through the ingestion pipeline.

Parameters

List[CreateMemoryRequest]
required
List of CreateMemoryRequest objects. Each entry has the same fields as memories.create (document, document_type, user_id, customer_id, mode, metadata, etc.). customer_id is required on B2B and auto-resolved on B2C (B2C vs B2B); mode is the ingestion axis (fast vs long-range) of Retrieval Modes.
boolean
If True, the entire batch is rejected as soon as any single document fails validation. If False (default), valid documents are accepted and invalid ones are returned with error_message populated in the per-item result.

Returns

BatchCreateResponse with aggregate counts and per-document results.
UUID
Unique identifier for the batch submission.
integer
Total number of documents submitted.
integer
Number of documents successfully queued.
integer
Number of documents that failed validation.
List[CreateMemoryResponse]
Per-document results. Each contains ingestion_id, document_id, status, queued_at, and an optional error_message if that document was rejected.

Example

Batch ingestion is more efficient than individual calls when you have multiple documents to process. The maximum batch size is 100 documents per call. For large-scale bootstrap operations, see the Bootstrap Ingestion guide.

Raises

  • SynapAuthError: when the API key is missing or invalid.
  • SynapValidationError: when the batch payload is malformed or exceeds the maximum size.

See also