API: Stable

A base type for requesting a bulk operation.

data class BulkRequest<T>(
    val items: List<T>,

⚠ WARNING: All request items listed in the bulk request must be treated as a single transaction. This means that either the entire request succeeds, or the entire request fails.

There are two exceptions to this rule:

  1. Certain calls may choose to only guarantee this at the provider level. That is if a single call contain request for multiple providers, then in rare occasions (i.e. crash) changes might not be rolled back immediately on all providers. A service MUST attempt to rollback already committed changes at other providers.

  2. The underlying system does not provide such guarantees. In this case the service/provider MUST support the verification API to cleanup these resources later.

items: List<T>