The exact moments behind a knowledge gap (M4 drill)
The raw unanswered_queries rows folded into a clustered gap (knowledge_gap_id = gapId), newest-first — each carrying the verbatim failing query, when it happened, and the conversation it lives in. This is the data-correct gap drill: the occurrences are PRECISELY linked, so the UI opens the real transcripts behind the gap instead of a phrase search that never matches a caller’s verbatim wording. 404 if the agent or gap is absent/cross-org.
Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
Path Parameters
The agent this resource is scoped to (the UUID returned by createAgent / listAgents).
The clustered knowledge-gap id whose verbatim occurrences you want to drill into.
Query Parameters
1-based page number for offset pagination. Defaults to 1 (the first page).
x >= 1Page size — how many items to return per page (1–100). Defaults to 20.
1 <= x <= 100