Responses for batch results
What’s the best response shape for a batch request?
Depending on your design, batch requests don’t always work and need success and failure responses back from the endpoint.
Salesforce return the item and a success field in each response item:
The AWS DynamoDB response returns a set of metadata, successes and failures:
I prefer a third option, which takes the best of both. Return a list of ids you’ve received, so requests can be tracked. Return an array of items that were successful and another list that has failed. The failed messages get an array of reasons they have failed.
References
</ul>