# Categories

Categories are used within a catalog to group products or other categories.

## List categories

 - [GET /catalogs/{catalogID}/categories](https://api-docs.sitecore.com/ordercloud/categories/categories.list.md)

## Create a category

 - [POST /catalogs/{catalogID}/categories](https://api-docs.sitecore.com/ordercloud/categories/categories.create.md): Setting adjustListOrders to true will increase ListOrder for all categories with the same or higher ListOrder.

## Retrieve a category

 - [GET /catalogs/{catalogID}/categories/{categoryID}](https://api-docs.sitecore.com/ordercloud/categories/categories.get.md)

## Create or update a category

 - [PUT /catalogs/{catalogID}/categories/{categoryID}](https://api-docs.sitecore.com/ordercloud/categories/categories.save.md): If an object with the same ID already exists, it will be overwritten.Setting adjustListOrders to true will increase ListOrder for all categories with the same or higher ListOrder.

## Delete a category

 - [DELETE /catalogs/{catalogID}/categories/{categoryID}](https://api-docs.sitecore.com/ordercloud/categories/categories.delete.md): Deleting a parent category will also delete all of that category's children.

## Partially update a category

 - [PATCH /catalogs/{catalogID}/categories/{categoryID}](https://api-docs.sitecore.com/ordercloud/categories/categories.patch.md): Setting adjustListOrders to true will increase ListOrder for all categories with the same or higher ListOrder.

## Delete a category assignment

 - [DELETE /catalogs/{catalogID}/categories/{categoryID}/assignments](https://api-docs.sitecore.com/ordercloud/categories/categories.deleteassignment.md)

## Delete a category bundle assignment

 - [DELETE /catalogs/{catalogID}/categories/{categoryID}/bundleassignments/{bundleID}](https://api-docs.sitecore.com/ordercloud/categories/categories.deletebundleassignment.md)

## Delete a category product assignment

 - [DELETE /catalogs/{catalogID}/categories/{categoryID}/productassignments/{productID}](https://api-docs.sitecore.com/ordercloud/categories/categories.deleteproductassignment.md)

## List category assignments

 - [GET /catalogs/{catalogID}/categories/assignments](https://api-docs.sitecore.com/ordercloud/categories/categories.listassignments.md)

## Create or update a category assignment

 - [POST /catalogs/{catalogID}/categories/assignments](https://api-docs.sitecore.com/ordercloud/categories/categories.saveassignment.md)

## List category bundle assignments

 - [GET /catalogs/{catalogID}/categories/bundleassignments](https://api-docs.sitecore.com/ordercloud/categories/categories.listbundleassignments.md)

## Create or update a category bundle assignment

 - [POST /catalogs/{catalogID}/categories/bundleassignments](https://api-docs.sitecore.com/ordercloud/categories/categories.savebundleassignment.md)

## List category product assignments

 - [GET /catalogs/{catalogID}/categories/productassignments](https://api-docs.sitecore.com/ordercloud/categories/categories.listproductassignments.md)

## Create or update a category product assignment

 - [POST /catalogs/{catalogID}/categories/productassignments](https://api-docs.sitecore.com/ordercloud/categories/categories.saveproductassignment.md)