Batch Operations

Preview

High-throughput mint and distribution: rate limits, chunking, and progress tracking.

For large events, large gift drops, and seed cohorts, the single-item APIs aren't the fastest path. Batch endpoints accept manifests and provide progress-tracked execution with partial-failure semantics.

This page is being written.

The structure is fixed. The prose is being drafted from the source material and reviewed by HeartChain Labs before publication. If you need this information urgently, email docs@heartbadge.com .

What this page will cover

When to batch vs. loop
Manifest format and size limits
Pre-flight dry-run validation
Rate limits and recommended throughput
Monitoring progress and handling partial failures
Reconciling outcomes against your source system