Add products and clusters to order list
PATCH/v2/orderlists/:id/add-items
Add individual products and/or product clusters to an existing order list.
Associates specified products and clusters with the order list, enabling bulk ordering and streamlined purchasing processes. The operation updates item assignments and availability automatically while maintaining data integrity.
This endpoint allows you to:
- Add individual products by their unique identifiers
- Add product clusters to include multiple related products
- Reference external products and clusters via source systems
- Maintain unique assignments (duplicates are automatically handled)
- Update the order list's modification timestamp
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Items added to order list successfully.
Returns the updated order list with the newly added products and clusters. The lastModifiedAt timestamp reflects when the items were added.
Invalid item data.
The provided item data contains validation errors such as invalid product or cluster IDs, malformed source references, or constraint violations. Ensure all product and cluster IDs are valid integers and exist in the system.
Authentication required.
Valid authentication credentials must be provided to modify order list items. Ensure your OAuth2 token is valid and properly formatted.
Access denied.
Insufficient permissions to modify order list items or the operation is restricted for your account. Verify that your account has the necessary permissions to modify order lists.
Order list not found.
No order list exists with the specified identifier, it has been deleted, or you don't have access to it. Verify the order list ID is correct and still exists in the system.
Server error.
An unexpected error occurred while adding items to the order list. Please try again later or contact support if the problem persists.