# Recategorize products in bulk

> POST /products/recategorize

Source: https://docs.trykintsugi.com/reference/2026-07-21/recategorize-products-in-bulk

POST /products/recategorize

Recategorize products in bulk

Move products in one organization from one category/subcategory to another. Every product matching `existingCategory`/`existingSubcategory` is reassigned to `newCategory`/`newSubcategory`, which must resolve to a supported tax code or the request returns 400. Pass `statusList` to move only products currently in those approval statuses. The reassignment runs asynchronously; the response is a 202 with `orgsQueued`. Send the target organization as `Organization-Id` when your credential owns more than one.

Category: Products

Request body:
existingCategory (PublicProductCategoryEnum, required) - Current top-level tax category of the products to move.
  allowed values: Digital, Misc, Physical, Services
existingSubcategory (string, required) - Current tax subcategory display label of the products to move (e.g. 'General Clothing'). With existingCategory it selects which products recategorize.
newCategory (PublicProductCategoryEnum, required) - New top-level tax category to assign to the matched products.
  allowed values: Digital, Misc, Physical, Services
newSubcategory (string, required) - New tax subcategory display label to assign (e.g. 'Catering'). With newCategory it must resolve to a supported product tax code; an unrecognized pair returns 400.
statusList (PublicProductStatusEnum[]) - Optional approval-status filter: only move products currently in one of these statuses. Omit to move every product matching the existing category/subcategory pair regardless of status.
  allowed values: APPROVED, PARTIALLY_APPROVED, PENDING, ARCHIVED

Response fields:
orgsQueued (integer, required) - Number of organizations queued for recategorization. Always 1: a recategorize targets the single organization resolved from your credential and any `Organization-Id` selector.

Response statuses: 202, 400, 401, 403, 404, 422

---

Index of every page: https://docs.trykintsugi.com/llms.txt