API Referenceinsights

Ask a research question

Research a question over the insight corpus and return a cited answer.

This is the slow, deep counterpart to POST /insights/search: multiple sub-searches plus an LLM synthesis instead of one ranked list.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

OR
X-API-Keystring
API Key authentication via header

Request

This endpoint expects an object.
querystringRequired8-1000 characters
The question to research.
answerbooleanOptionalDefaults to false

Default returns the agent-curated evidence (sources) with answer: null in ~10-30s. Set true for a written, cited answer — adds ~15-25s.

include_quotesbooleanOptionalDefaults to false

Attach the verbatim transcript passage to each source as quote — the same grounding /insights/search offers. Adds ~1-2s.

Response

Successful Response
querystring
answerstring or null

Markdown synthesis with [n] citations; null when no evidence was found.

sourceslist of objects

The agent-curated evidence set, best-first.

took_msinteger
debugmap from strings to any
note_typeenum

Null when evidence was found. source_not_covered = a named show/episode is not in the corpus; no_evidence = covered ground, nothing matched the question.

noteany

One-sentence human explanation paired with note_type; null when evidence was found.

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error