# moveCategory

## Overview

Moves a category to a different parent within the category hierarchy.

## Modules Commands Used

- `product-management.MoveProductCategory` — validates the target position for circular references and depth limits, then updates the parent link

## Exception Handling

| Error Code | Description |
| --- | --- |
| CATEGORY_NOT_FOUND | No category exists with the given ID |
| PARENT_NOT_FOUND | The specified new parent category does not exist |
| CIRCULAR_REFERENCE | Moving the category to the target parent would create a cycle in the hierarchy |
| MAX_DEPTH_EXCEEDED | The resulting hierarchy depth would exceed the allowed maximum |
