# Families

## List families

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

## Create family

 - [POST /v1/families](https://docs.apiera.io/openapi/families/paths/~1v1~1families/post.md): Creates a new family. Categories and attributes must be added separately after creation.

## Get family

 - [GET /v1/families/{familyUuid}](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1%7Bfamilyuuid%7D/get.md): Retrieves complete details for a single family.

## Update family

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

## Delete family

 - [DELETE /v1/families/{familyUuid}](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1%7Bfamilyuuid%7D/delete.md): Permanently deletes a family. Cannot be undone.

## Bulk create families

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

## Bulk update families

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

## Transition family lifecycle

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

## Bulk transition family lifecycle

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