Skip to main content

Add products and clusters to a category

POST 

/categories/:lookupKey/:lookupValue/add-products-clusters

Add products and clusters to an existing category using flexible identification methods. This endpoint supports bulk operations with detailed response reporting for each item.

Important: Products and clusters maintain their primary category assignment and are not moved from their current parent. This operation creates additional category associations, allowing items to belong to multiple categories simultaneously. This is a key feature of our system that enables flexible product categorization.

Key Features

  • Flexible Identification: Use internal id or external sourceId + source combination
  • Bulk Operations: Add multiple products and clusters in a single request
  • Detailed Reporting: Get individual success/failure status for each item
  • Lookup Key Support: Use lookup keys for flexible category identification
  • Multi-Category Support: Products and clusters can belong to multiple categories simultaneously
  • Non-Destructive: Items remain in their primary category while gaining additional category associations

Request

Responses

Add products and clusters to a category - 200