Collections

Collections are flat, manually curated product sets — typically used for campaigns (“Spring Sale”), editorial rails (“Staff picks”), or cross-sells. Unlike categories, collections are not hierarchical and do not drive URL structure.

Endpoints

GET/api/b2b/pim/collectionsauth: session
GET/api/b2b/pim/collections/:slugauth: session
POST/api/b2b/pim/collectionsauth: session
PATCH/api/b2b/pim/collections/:slugauth: session
DELETE/api/b2b/pim/collections/:slugauth: session
POST/api/b2b/pim/collections/:slug/productsauth: session
DELETE/api/b2b/pim/collections/:slug/products/:entity_codeauth: session

Notes

  • Products are referenced by entity_code. A product can belong to any number of collections simultaneously.
  • Ordering within a collection is stored as an ordered array of entity_codes; PATCH with a new order to reorder.