2026-10 Release Notes

Products

New Endpoints

GET /api/2026-10/products: Lists products with support for pagination and includes. Requires products:read scope.
GET /api/2026-10/products/{product_id}: Retrieves a single product by ID. Requires products:read scope.
GET /api/2026-10/products/{product_id}/family: Retrieves the product family for a given product. Requires products:read scope.
PATCH /api/2026-10/products/{product_id}: Partially updates a product. Requires products:write scope.
DELETE /api/2026-10/products/{product_id}: Deletes a product. Requires products:write scope.
POST /api/2026-10/products/{product_id}/images: Adds an image to a product. Requires products:write scope.
DELETE /api/2026-10/products/{product_id}/images/{image_id}: Deletes an image from a product. Requires products:write scope.
POST /api/2026-10/products/generate_product_codes: Generates unique product codes from the retailer SKU sequence. Requires products:write scope.

Behavior changes

The products API now uses an explicit family relationship instead of legacy parent and variant inference. Each product belongs to a family via family_id.

Product create and add flows require codes[] for each product. If your integration relied on implicit SKU generation, generate codes first via POST /api/2026-10/products/generate_product_codes.

Product families

New Endpoints

POST /api/2026-10/product_families: Creates a product family and its initial products. Requires products:write scope.
GET /api/2026-10/product_families/{product_family_id}: Retrieves a product family by ID. Requires products:read scope.
PATCH /api/2026-10/product_families/{product_family_id}: Partially updates a product family. Requires products:write scope.
DELETE /api/2026-10/product_families/{product_family_id}: Deletes a product family and all member products. Requires products:write scope.
POST /api/2026-10/product_families/{product_family_id}/products: Adds products to an existing product family. Requires products:write scope.
POST /api/2026-10/product_families/{product_family_id}/images: Adds an image to a product family. Requires products:write scope.
DELETE /api/2026-10/product_families/{product_family_id}/images/{image_id}: Deletes an image from a product family. Requires products:write scope.

Migration notes

Legacy product flows from 2.0, 2.1, 3.0, 2026-01, 2026-04, and 2026-07 are superseded by the 2026-10 model.

The previous combined family and product update pattern has been split:

use PATCH /api/2026-10/product_families/{product_family_id} for family-level updates
use PATCH /api/2026-10/products/{product_id} for product-level updates

Deprecations

Legacy product and variant flows are superseded by the 2026-10 endpoints above. Integrations should migrate to explicit product_family resources and family_id-based relationships.

For endpoint mapping and payload examples, see Migrating to the 2026-10 Products API.