distillery_store_batch
Batch import multiple knowledge entries in one call; valid entries persist, per-item failures reported. Use for bulk migrations or backfills where dedup isn't needed.
Instructions
Batch-store multiple knowledge entries in one call (no dedup/conflict checks).
USE WHEN: bulk-importing entries (e.g. GitHub history sync, migration, backfill) where per-entry dedup is unnecessary and throughput matters.
PARAMS:
entries (list[dict], required): List of entry dicts. Each must have:
content (str, required): The knowledge content.
author (str, required): Who authored this entry.
entry_type (str, optional, default="inbox"): Entry classification. Valid: [session, bookmark, minutes, meeting, reference, idea, inbox, github, person, project, digest, feed].
tags (list[str], optional): Tags for categorisation.
metadata (dict, optional): Arbitrary key-value metadata.
source (str, optional, default="claude-code"): Origin of the entry.
project (str, optional): Per-entry project override.
project (str, optional): Default project applied to entries lacking one.
RETURNS (success): { entry_ids: list[str | None], # per-item ids; null for failed items count: int, # number actually persisted results: list[dict], # per-item status preserving input order }
Successful items: { entry_id, persisted: true, dedup_action: "stored" }
Failed items: { entry_id: null, persisted: false, error: { code, message, details? } } Validation failures on individual items no longer abort the batch — valid entries are persisted and failures are reported per item in
results(issue #364). Iterateresultsto discover failures. RETURNS (error): { error: true, code: "INVALID_PARAMS" | "BUDGET_EXCEEDED" | "INTERNAL", message: "..." } Top-level error is returned only for schema-level problems (entriesnot a list, budget exhaustion, persistence failure).
RELATED: distillery_store (single entry with dedup/conflict checks), distillery_watch (add feed sources with optional history sync)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entries | Yes | ||
| project | No |