# Categories

## List categories

 - [GET /v1/categories](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories/get.md): Retrieves a paginated list of categories with optional filtering.

## Create category

 - [POST /v1/categories](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories/post.md): Creates a new category.

## Bulk create categories

 - [POST /v1/categories/bulk](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1bulk/post.md): Creates multiple categories in a single atomic operation.

## Bulk update categories

 - [PATCH /v1/categories/bulk](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1bulk/patch.md): Updates multiple categories in a single operation.

## Get category

 - [GET /v1/categories/{categoryUuid}](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D/get.md): Retrieves complete details for a single category.

## Update category

 - [PATCH /v1/categories/{categoryUuid}](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D/patch.md): Updates an existing category. Only provided fields are updated.

## Delete category

 - [DELETE /v1/categories/{categoryUuid}](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D/delete.md): Permanently deletes a category. Cannot be undone.

## Transition category lifecycle

 - [PATCH /v1/categories/{categoryUuid}/actions/lifecycle](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D~1actions~1lifecycle/patch.md): Transitions a category to a different lifecycle state. Valid transitions depend on current status.

## Bulk transition category lifecycle

 - [PATCH /v1/categories/bulk/actions/lifecycle](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1bulk~1actions~1lifecycle/patch.md): Transitions multiple categories to a different lifecycle state in a single operation.