Skip to main content

Taxonomy category

A taxonomy category is a classification within a taxonomy level, such as style/item or material taxonomy, that has a unique identifier and may have a parent category, forming a hierarchy you use to organize your products. With the new Taxonomy Category APIs, you can create, retrieve, update, and delete these categories directly from your own systems, instead of relying on CSV uploads or manual edits in the UI. This gives you a faster and more reliable way to keep your product classifications accurate as your business needs change.

Precondition​

Generate an API key for your organization and use it to authenticate your API requests.

Create or Restore Category​

The Create or Restore Category API endpoint creates a new category or restores a category that was previously soft-deleted at the same taxonomy level. You can use this single endpoint for creating or restoring a category.

To create or restore a category, use the POST Create or Restore Category API endpoint.

List Categories​

The List Categories API endpoint returns a paginated list of categories at a given taxonomy level, scoped to your organization. Use this endpoint when you need to browse or search categories rather than retrieve one specific category.

To retrieve the list of categories, use the GET List Categories API endpoint.

Update Category​

The Update Category API endpoint updates the mutable fields of a live category. Use this endpoint when you only need to change a category's name and/or description.

To update a category’s name and description, use the PUT Update Category API endpoint.

Delete Category​

The Delete Category API endpoint soft-deletes a category and all of its descendant categories. Use this endpoint when you need to remove a category while keeping the option to restore it later.

To delete a category, use the Delete Category API endpoint.

Get Category​

The Get Category API endpoint returns a single category by its customId. Use this endpoint when you already know the exact category you need.

To retrieve a category, use the Get Category API endpoint.