Get session insights
Retrieve insights for a specific session with pagination.
When no insights_session row exists for the given sessionId
(caliperSessionId) — for example, immediately after a session
starts but before the asynchronous Caliper ingestion pipeline has
materialized the row — the endpoint returns 200 with an empty
result (insights: [], total: 0, and a default session summary
with zero duration). This mirrors the behavior of getUserInsights
when no sessions match. Findings stamped rolloutState=SHADOW are omitted;
unstamped (null) findings remain visible.
Authorizations
OAuth 2.0 client credentials flow. Contact timeback@trilogy.com to request credentials for your application.
Path Parameters
Session ID to retrieve insights for (URL-encoded if necessary)
Query Parameters
Maximum number of items to return
1 <= x <= 100Number of items to skip
x >= 0Optional flag to filter insights by proctored status
Comma-separated list of insight type slugs to filter by. Takes precedence over insightGroups, category, and default.
"PhysicalVerbalSocializing,OnlineAppFocusSwitch"
Comma-separated list of stable Insight Group slugs to filter by. Display names are served by GET /insights/1.0/insight-groups. Takes precedence over category and default, but is overridden by type (or insightTypes on session endpoints). On endpoints that return insights, selects matching insights. On endpoints that return sessions, a session is returned only if it carries at least one caller-visible insight of a member type, and the session's metrics scope to the filter.
"StayFocused,DistractionFreeSpace"
Comma-separated list of categories to filter by. Takes precedence over the default but is overridden by type and insightGroups.
"AcademicIntegrity,Observability,OnlineEnvironment,PhysicalEnvironment"
Response
Successful response with insights and session summary
Unified paginated insights response with session summary