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.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
Current top-level tax category of the products to move.
DigitalMiscPhysicalServicesCurrent tax subcategory display label of the products to move (e.g. 'General Clothing'). With existingCategory it selects which products recategorize.
New top-level tax category to assign to the matched products.
DigitalMiscPhysicalServicesNew 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.
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.
APPROVEDPARTIALLY_APPROVEDPENDINGARCHIVEDResponse
Number of organizations queued for recategorization. Always 1: a recategorize targets the single organization resolved from your credential and any Organization-Id selector.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request failed validation.