Data API — Models

Attributes:
    id (UUID): Unique identifier for this API key.
    description (None | str): Description to help identify the key's purpose.
    hint (None | str): Short random prefix of the key for identification.
    key (None | str): The full API key value. Only returned at creation time.
    expires_at (datetime.datetime | None | Unset): When the key expires. Null if no expiration.
    date_created (datetime.datetime | None | Unset): When this API key was created.

Attributes:
    conditions (list[ConfigurationCondition]): The conditions that are selected that reduce refine the way the order
        is executed and therefore the number of participants required.
    start (datetime.datetime | None | Unset): The start of the time period that is being searched for available time
        slots. If not provided, defaults to now.
    end (datetime.datetime | None | Unset): The end of the time period that is being searched for available time
        slots. If not provided, defaults to 7 days from now.
    user_id_filter (None | Unset | UUID): Optional filter to only return commitments for orders created by or
        requested for this user.
        When provided, only commitments where Order.CreatedByUserId or WorkOrder.RequestedByUserId matches this value
        are returned.
        When not provided, all commitments are returned.

Attributes:
    participants (list[ParticipantIdentifier]): Participants to query. Empty is allowed and returns an empty
        snapshot.
    start (datetime.datetime): Window start (inclusive).
    end (datetime.datetime): Window end (exclusive).

Attributes:
    id (UUID): Entry id.
    name (str): Display label shown on the calendar.
    children (list[CalendarEntryResponse]): Child entries (per-task rows under a workflow-order parent). Empty for
        leaf entries and for work-order-sourced entries.
    parent_calendar_entry_id (None | Unset | UUID): Parent entry id; null for top-level entries.
    source_workflow_order_id (None | Unset | UUID): Originating workflow order id on top-level workflow entries;
        null for
        child entries and for work-order-sourced entries.
    estimated_duration (None | str | Unset): Planner-provided duration estimate; null for unplaced templates.
    planned_start (datetime.datetime | None | Unset): Absolute start time once placed; null for unplaced templates.
    planned_end (datetime.datetime | None | Unset): Absolute end time once placed; null for unplaced templates.
    due_date (datetime.datetime | None | Unset): Optional soft target by which the entry should be completed.
        Set on top-level (parent) entries only in 1.17 -- per-task due dates may
        be added later. Distinct from Cellario.Cloud.Data.Api.Models.Calendar.CalendarEntryResponse.PlannedEnd: due date
        is the
        customer-/operator-stated commitment, while
        Cellario.Cloud.Data.Api.Models.Calendar.CalendarEntryResponse.PlannedEnd is
        the scheduler's actual placement. Null when no due date is specified.
    participant_pool (None | ParticipantPoolRecord | Unset): X-of-N pool claim (JSONB). Null for entries with no
        pool -- guided
        tasks, parent entries, and all 1.17 entries until pool authoring ships.
    release (None | ReleaseRecord | Unset): Release metadata (JSONB). Null while active; populated on cancel or
        reschedule with who released it, when, and why.
    created_by_user_id (None | Unset | UUID): User id of the operator who created the originating workflow order.
        Populated on top-level workflow entries only; null on child entries and
        on work-order-sourced entries. Returned as a raw id -- the UI resolves
        the user name on demand (e.g. tooltip hover).
    workflow_order_user_facing_id_prefix (None | str | Unset): User-facing id prefix captured at placement (e.g.
        `"SCI"`).
        Parent entries only; null on children. The UI assembles the display id
        as `{prefix}-{number}`.
    workflow_order_user_facing_id_number (int | None | Unset): User-facing id number captured at placement. Parent
        entries only;
        null on children.
    workflow_order_state (None | Unset | WorkflowOrderState): Live workflow-order state read fresh on every list
        call. Parent
        entries only; null on children. Null when the source workflow order
        could not be resolved (data drift -- the FK is RESTRICT but the
        response prefers explicit absence to falsifying state).
    workflow_order_step_id (None | Unset | UUID): FK back to the originating `WorkflowOrderStep`. Populated on child
        entries that map 1:1 to a workflow step; null on parents and on
        work-order-sourced entries. Lets the UI fetch the step's runtime state
        (in-progress, failed, etc.) when it needs to color-code the row beyond
        the static Cellario.Cloud.Data.Api.Models.Calendar.CalendarEntryResponse.StepType classification.
    parent_workflow_order_step_id (None | Unset | UUID): Immediate parent of
        Cellario.Cloud.Data.Api.Models.Calendar.CalendarEntryResponse.WorkflowOrderStepId in the workflow-order
        step tree -- the enclosing branch arm, parallel-split arm, loop body, etc.
        Lets the calendar UI assign per-branch lanes to overlapping children
        without re-fetching the step tree for each order. Null on parent entries,
        on work-order-sourced entries, on top-level workflow steps that have no
        container, and when the source step's parent could not be resolved
        (consistent with Cellario.Cloud.Data.Api.Models.Calendar.CalendarEntryResponse.WorkflowOrderStepId's
        nullability).
    step_type (CalendarEntryStepType | None | Unset): Coarse step classifier derived from the originating step's
        `HintsJson["elementType"]`. Drives the default child-row dot color
        and type label in the calendar UI. `Unknown` when the source step
        has no recognizable element type or could not be located.
    step_state (None | Unset | WorkflowStepState): Live workflow-step state read fresh on every list call. Child
        entries
        only; null on parents. Null when the source step could not be
        resolved.
    committed_worker (CommittedWorkerRecord | None | Unset): Participant committed to this child entry (the "worker"
        rendered inline
        on the calendar row). Null on guided steps (no commitment) and when the
        commitment's participant could not be resolved.