Get analytics insights for a version
Computes deterministic red flags / proactive insights (low metric scores, specification coverage gaps) for a single version, plus a fail-open LLM-generated narrative summary. See Platform Overview.
Authorizations
API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....
Query Parameters
Product ID (required)
Version ID to compute insights for (required)
Filter by test IDs
Filter by metric IDs
Filter by language codes
Start date for filtering
End date for filtering
When true (default), a fail-open LLM-generated narrative summary is computed and returned alongside the deterministic flags. When false, the narrative LLM call is skipped entirely and the response carries narrative: null and narrativeGeneratedByAi: false; the deterministic flags are unchanged. Machine consumers that produce their own prose should pass false to avoid the wasted LLM call.
When set, returns only production (true) or only development (false) data. Omit to include both.
Response
Analytics insights computed successfully
Single-version analytics insights: deterministic flags plus a fail-open LLM-generated narrative summary (the narrative is omitted when the request sets includeNarrative=false).
"prod_123"
"ver_123"
"v3"
all_good, flags_present "flags_present"
True when the narrative was successfully produced by the LLM; false otherwise (including when includeNarrative=false).
LLM-generated narrative summary, or null when generation was skipped (includeNarrative=false or no flags) or failed.
"Faithfulness dropped sharply on v3 and two specifications still have no coverage."