Create or update clusters in bulk with nested relations
POST/v2/clusters/bulk/:lookupKey
Processes up to one thousand clusters in a single request, creating new clusters and updating existing ones, along with their nested products and options.
Each cluster may include its products and its cluster options inline. Each option may further include its products. Matching for the top-level cluster is driven by the lookup method declared on the URL; nested relations follow the same lookup conventions. Per-item outcomes are returned for the main cluster and for every nested relation, so callers can detect partial successes and retry only the items that failed.
Request
Responses
- 200
- 400
- 401
- 403
- 500
The bulk request completed; per-item outcomes are reported in the response payload.
The request payload, path, or query parameters failed validation.
Authentication credentials are missing or invalid.
The authenticated caller is not permitted to perform the operation.
An unexpected error prevented the request from completing.