advanced · requests

Batch of 5, 2 Fail

A client submits a batch of 5 operations and 2 fail. What should the API do — and what must the contract have said beforehand?

Practical scenario

A bulk contact-import endpoint returns 400 when any row fails validation, so a customer's 10,000-row import dies on row 7,842 with no record of what was created.

What it tests

  • • Atomic vs independent batch semantics as an explicit contract choice
  • • Per-item result reporting design
  • • Retry interaction: what does the client resend?