Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Insights Endpoints

Insights endpoints provide generated reports and session analysis.

Get the latest insights report.

GET /v1/insights/report?scope=personal
Authorization: Bearer gck_your_key
ParameterTypeDefaultDescription
scopestringpersonalReport scope
fromISO8601Start time
toISO8601End time

Returns the most recent generated report as a JSON payload.

Generate a new insights report on demand.

POST /v1/insights/report/generate
Authorization: Bearer gck_your_key

Triggers asynchronous report generation. Returns immediately with a report ID.

Get report generation history.

GET /v1/insights/report/history?scope=personal&limit=20
Authorization: Bearer gck_your_key
ParameterTypeDefaultDescription
scopestringpersonalReport scope
limitinteger20Max records

Get a specific report by ID.

GET /v1/insights/report/abc123
Authorization: Bearer gck_your_key

Session type statistics for a time range.

GET /v1/insights/sessions/stats?from=2024-01-01T00:00:00Z&to=2024-01-31T00:00:00Z
Authorization: Bearer gck_your_key
ParameterTypeDefaultDescription
fromISO860130 days agoStart time
toISO8601nowEnd time

Session highlights — notable sessions based on scoring, patterns, or anomalies.

GET /v1/insights/sessions/highlights?from=2024-01-01T00:00:00Z&to=2024-01-31T00:00:00Z
Authorization: Bearer gck_your_key
ParameterTypeDefaultDescription
fromISO860130 days agoStart time
toISO8601nowEnd time