Skip to main content
GET
Widget identity is verified when signing is configured; tokenless compatibility does not establish tenant ownership. See the authentication and recovery guide for credential and retry rules.

Query parameters

string
Ignored by the analytics routes (telemetry, response review, thread analytics): their org comes only from the verified widget token, and they answer 401 unauthorized without one (outside production, STATESET_ORG_ID is a logged fallback). Kept for older clients.
string
Agent id hint (also agent_id, or header x-agent-id). Overridden by the widget token when present; must match it.
integer
Records to analyze; default 5000, max 10000.
string
integer
string
<n>d for the last n days (1-365) or all; omitted means no lower bound.

Response

ThreadAnalyticsReport
boolean
required
Fixed value: true.
string (date-time)
required
string,null
required
string,null
required
integer
required
string,null
required
string,null (date-time)
required
boolean
required
true when the record count hit limit.
object
required
Output of analyzeThreadResponseAnalytics (src/server/threadAnalytics.js): includes singleResponseReasons, multiResponseReasons, daily, pairCountDistribution and, with includeThreads=true, sampled threads. Exact shape is not fixed here.
string[]
required

Status codes

Using this contract

Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.
Last modified on November 13, 2026