SessionInsightOutput

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 /signals/1.0/insights/groups; it is not a fixed list.
- insightType
  Type:
  required
  
  Insight type slug (data-driven, see GET /insights/1.0/types for available types)
- officerDecision
  Type: nullable
  required
  
  The officer decision recorded on this insight; null when none
  
  Properties: 5
- reason
  Type: string
  required
  
  Detailed reason or description for the insight
- severity
  Type: "red" or "orange"enum
  required
  
  Safety severity for this occurrence. red reaches the school safety officer; orange is stored and counted but hidden. Null for insights without a severity.
- 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. Null when no rollout policy governed the finding.

SessionSummaryOutput

PaginatedSessionInsightsOutput