Insights & Reports

Report generation is reached two ways:

1. Ingest report proxies — a small set of report endpoints exposed on the ingest service (the single public surface) for the plugin and external callers: GET /v1/insights/report, POST /v1/insights/report/generate, and POST /v1/insights/report/quick.
2. Prompt Score v3.0 reports — the /v1/score_v3/report/* family on the Prism API, which backs the dashboard’s v3 report view.

Note

The API’s older /v1/insights/report/* status/pending/cancel/history and /v1/insights/sessions/* families have been removed. The three report endpoints below are the survivors, hosted by ingest; they carry the same gck_* authentication as any other ingest endpoint.

GET /v1/insights/report

Hosted by ingest. Returns the latest generated 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

Hosted by ingest. Generates a new insights report on demand. Runs synchronously and returns the full report payload in the response — there is no job ID.

POST /v1/insights/report/generate?scope=personal
Authorization: Bearer gck_your_key
Accept-Language: en

Parameter	Type	Default	Description
scope	string	personal	Report scope tag (see note below)
from	ISO8601	—	Start time
to	ISO8601	—	End time

The Accept-Language header (default en) selects the report’s output language.

Note on scope: scope is treated as an arbitrary tag persisted alongside the report row — it isn’t validated against a fixed enum; personal is the common default.

POST /v1/insights/report/quick

Hosted by ingest. A synchronous, LLM-free report — the fast path for a lightweight write-up without waiting on model inference.

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

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

Prompt Score v3.0 reports

Report generation for v3-scored data has its own endpoint family on the Prism API. See the Prompt Score v3.0 page for the failure-status contract and daily-range parameters.

Endpoint	Method	Purpose
/v1/score_v3/report	GET	Latest v3 report (accepts scope / from / to)
/v1/score_v3/report/generate	POST	Generate a v3 report; Accept-Language selects output language
/v1/score_v3/report/pending	GET	Most recent in-progress v3 report, or 200 {"report_id": null}
/v1/score_v3/report/status/:id	GET	Status of a running v3 generation
/v1/score_v3/report/cancel/:id	POST	Cancel a running v3 generation
/v1/score_v3/report/history	GET	Past v3 reports (scope, limit)
/v1/score_v3/report/:id	GET / DELETE	Fetch or delete one v3 report