Insights Endpoints

Insights endpoints provide generated reports and session analysis.

GET /v1/insights/report

Get the latest insights report.

GET /v1/insights/report?scope=personal
Authorization: Bearer gck_your_key

Parameter	Type	Default	Description
scope	string	personal	Report scope
from	ISO8601	—	Start time
to	ISO8601	—	End time

Returns the most recent generated report as a JSON payload.

POST /v1/insights/report/generate

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 /v1/insights/report/history

Get report generation history.

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

Parameter	Type	Default	Description
scope	string	personal	Report scope
limit	integer	20	Max records

GET /v1/insights/report/:id

Get a specific report by ID.

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

GET /v1/insights/sessions/stats

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

Parameter	Type	Default	Description
from	ISO8601	30 days ago	Start time
to	ISO8601	now	End time

GET /v1/insights/sessions/highlights

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

Parameter	Type	Default	Description
from	ISO8601	30 days ago	Start time
to	ISO8601	now	End time