InsightOutput

Unified insight information

  • durationInSeconds
    Type: integer
    required

    Duration of the insight in seconds

  • endedAtTime
    Type: string Format: date-time
    required

    Timestamp when the insight period ended

  • id
    Type: string Format: uuid
    required

    Unique identifier for the insight

  • insightGroup
    Type: string | null
    required

    Stable Insight Group slug for this insight's type; null when the type has no group (for example, Journal). The published set is served by GET /insights/1.0/insight-groups; it is not a fixed list.

  • insightType
    Type: string · InsightType
    required

    Insight type slug (data-driven, see GET /insights/1.0/types for available types)

  • reason
    Type: string
    required

    Detailed reason or description for the insight

  • startedAtTime
    Type: string Format: date-time
    required

    Timestamp when the insight period started

  • version
    Type: string · InsightVersion
    max length:  
    16
    required

    Version of the insight

  • messageVersion
    Type: integer | null

    Pinned catalog message bundle version; null for legacy insights

  • rolloutState
    Type: string | null enum

    Rollout stage recorded at detection for the student's school, not the school's current stage. Dashboard GETs (getUserInsights, getSessionInsights) omit SHADOW; getSessionNotifications may still return it. Null when no rollout policy governed the finding.

    values
    • SHADOW
    • NOTIFY
    • ENFORCE