Organization
Create Product Brand
Creates a new product brand.
List Product Brands
Returns a paginated list of product brands.
Bulk Delete Product Brands
Bulk deletes multiple product brands by ID.
Get Product Brand
Returns a single product brand by ID.
Update Product Brand
Updates a product brand's name.
Delete Product Brand
Deletes a product brand. Fails if any products are still linked to the brand.
Archive Product Brand
Archives a product brand. Sets archived_at timestamp. Returns a warning if already archived.
Unarchive Product Brand
Unarchives a product brand. Clears archived_at. Returns a warning if already active.
Bulk Archive Product Brands
Bulk archives multiple product brands.
Bulk Unarchive Product Brands
Bulk unarchives multiple product brands.
Check Product Brands Deletable
Checks whether each of the given product brand IDs can be safely deleted. A brand is not deletable if products are linked to it.
Search Product Brands
Simple search endpoint returning up to 50 product brands matching the name. Returns product brand object collection.
Preview Product Brands Import
Preview the result of importing product brands from a CSV/Excel file without committing the import.
Import Product Brands
Imports product brands from a CSV or Excel file. Each row must have a `name` column.
Get Brand Detail Summary
Returns a single brand with lightweight aggregate stats for the Brand detail page header. Includes archived brands (a deep-link to an archived brand still resolves).
Get Brand Activity Log
Paginated, filterable activity log for a brand. Surfaces two signals: the brand's own events (rename, archive, restore) and product brand-assignment changes (a product's brand being set to or cleared from this brand).
Get Category
Show a single product category with full detail including children, attribute groups, attributes, parent, and root info.
Update Category
Update an existing product category. Attribute groups and attributes are synced (replaced entirely if provided).
Delete Category
Delete a product category. Only leaf categories (is_leaf = true) can be deleted.
Create Category
Create a new product category.
List Categories
List product categories. Supports search, sort, pagination, and archiving filters.
Bulk Delete Categories
Bulk delete multiple product categories by their IDs. Only leaf categories can be deleted.
Get Category Tree
Returns all categories as a nested tree structure for hierarchical display.
List Categories (Management View)
Returns categories at a specific level for the product category assignment/manage UI. Includes counts for products, attributes, and attribute groups.
Assign Category to Product
Assign a category to a product and optionally set it as the primary category. Uses updateOrCreate so re-posting changes is_primary.
Reassign Category to Products
Bulk reassign all products from one leaf category to another. Products already in the new category are detached from the old one.
Archive Category
Archive a single product category.
Unarchive Category
Unarchive a single product category.
Bulk Archive Categories
Bulk archive multiple product categories by their IDs.
Bulk Unarchive Categories
Bulk unarchive multiple product categories by their IDs.
Check Categories Deletable
Check which categories can be deleted. Categories with children (is_leaf = false) cannot be deleted.
Preview Categories Import
Preview a category import file before committing. Returns parsed rows and any validation errors.
Import Categories
Import categories from a CSV or Excel file.
Get Attribute
Returns a single attribute with its group and option values.
Update Attribute
Updates an existing attribute. All fields are optional (PATCH semantics). Providing option_values syncs them — values not included will be deleted.
Delete Attribute
Deletes an attribute along with its values and product attribute assignments. Returns an error if the attribute is used by products unless ignore_relations=1.
Get Attributes Grouped
Returns all attributes organized by their attribute group, plus a list of ungrouped attributes.
Create Attribute
Creates a new attribute.
Bulk Delete Attributes
Bulk deletes multiple attributes by ID array or current list view filters.
List Attributes
Returns a paginated list of attributes.
Archive Attribute
Archives a single attribute. Idempotent — returns a warning if already archived.
Unarchive Attribute
Unarchives a single attribute.
Bulk Archive Attributes
Bulk archives multiple attributes by ID array or current list view filters.
Bulk Unarchive Attributes
Bulk unarchives multiple attributes by ID array or current list view filters.
Check Attributes Deletable
Checks whether each provided attribute ID can be safely deleted.
Import Attributes
Imports attributes from a CSV or Excel file.
Preview Attributes Import
Previews attribute import data from a file without actually importing.
List Attribute Groups (Management View)
Returns all attribute groups ordered by sort_order, including nested attributes, product counts, and category counts. Used for the attribute group management page.
Get Attribute Group
Returns a single attribute group with full details including products, categories, and attributes.
Update Attribute Group
Updates an existing attribute group. All fields are optional (PATCH semantics on PUT). Providing the attributes array syncs assigned attributes — attributes not included will be removed from the group.
Delete Attribute Group
Deletes a single attribute group. Returns an error if the group is linked to categories or products.
Create Attribute Group
Creates a new attribute group. Optionally assigns existing attributes to the group.
Bulk Delete Attribute Groups
Bulk deletes multiple attribute groups by ID array or by current list view filters.
List Attribute Groups
Returns a paginated list of attribute groups. Supports search, sort, and archive filtering.
Archive Attribute Group
Archives a single attribute group by ID. Idempotent — returns a warning if already archived.
Unarchive Attribute Group
Unarchives a single attribute group by ID.
Bulk Archive Attribute Groups
Bulk archives multiple attribute groups by ID array or by current list view filters.
Bulk Unarchive Attribute Groups
Bulk unarchives multiple attribute groups by ID array or by current list view filters.
Check Attribute Groups Deletable
Checks whether each provided attribute group ID can be safely deleted (not linked to categories or products).
Import Attribute Groups
Imports attribute groups from a CSV or Excel file.
Preview Attribute Groups Import
Previews attribute group import data from a file without actually importing. Returns rows with validation status.