InsightOutput

Unified insight information

durationInSeconds
Type: integer
required

Duration of the insight in seconds
endedAtTime
Type: stringFormat: date-time
required

Timestamp when the insight period ended
id
Type: stringFormat: 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:
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: stringFormat: date-time
required

Timestamp when the insight period started
version
Type:
max length:
16
required

Version of the insight
messageVersion
Type: integer | null

Pinned catalog message bundle version; null for legacy insights
rolloutState
Type: "SHADOW" or "NOTIFY" or "ENFORCE"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.