# Create family

Creates a new family. Categories and attributes must be added separately after creation.

Endpoint: POST /v1/families
Version: 1.0.0
Security: Bearer

## Request fields (application/json):

  - `parentUuid` (string,null)
    Optional parent family UUID for hierarchical organization.

  - `name` (string, required)
    Display name for the family.

  - `description` (string,null)
    Optional detailed description of the family's purpose and scope.

## Response 201 fields (application/json):

  - `uuid` (string, required)
    Unique identifier for this family.

  - `parentUuid` (string,null)
    Identifier of the parent family for hierarchical organization. Null if this is a root family.

  - `createdAt` (string, required)
    Timestamp when this family was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt` (string, required)
    Timestamp when this family was last modified.
    Example: "2025-11-23T14:15:22.123456Z"

  - `removedAt` (string,null)
    Timestamp when this family was removed. Null if not removed.
    Example: "2025-11-23T14:15:22.123456Z"

  - `status` (string, required)
    Current lifecycle status of this family.
    Enum: "draft", "active", "inactive", "removed"

  - `name` (string, required)
    Display name for this family.

  - `description` (string,null)
    Detailed description of the family's purpose and which products it applies to.

## Response 401 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

## Response 403 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 409 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 422 fields (application/problem+json):

  - `errors` (array)

  - `errors.code` (string, required)

  - `errors.message` (string, required)

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 500 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)