topic
Verified 2026-09-18

Bulk API Operations

Bulk endpoints apply one request to multiple resources and must define partial success, ordering, limits, and retry behavior.

Choose 200 or 207 when individual results are available, 202 when processing is queued, and an explicit item-level result shape for partial failures. Bound item count and body size, preserve idempotency, and make retries safe.

httpapibatchreliability

Reference (http)

POST /api/bulk/users HTTP/1.1
Idempotency-Key: bulk-01
Content-Type: application/json

{"items":[{"id":"u1","op":"disable"}]}

Choose 200 or 207 when individual results are available, 202 when processing is queued, and an explicit item-level result shape for partial failures. Bound item count and body size, preserve idempotency, and make retries safe.

Common mistakes

  • Claiming the entire batch succeeded after one item failed, allowing unbounded item counts, or retrying a non-idempotent batch without a deduplication strategy.
Permalink: https://merginit.com/reference/http/api-bulk-operations