Create or update categories in bulk
POST/v2/categories/bulk/:lookupKey
Processes up to one thousand categories in a single request, creating new categories and updating existing ones.
Matching is driven by the lookup method declared on the URL: every item is matched against the existing catalogue using either its internal identifier or its external source identifier. Items that do not match an existing category are created.
Per-item outcomes are returned in the response so callers can detect partial successes and retry only the items that failed. Directives may be supplied to fine-tune update behaviour, for example to skip updates of populated fields or to reset specific lists when updating.
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.