Skip to main content
POST
Query the research RAG corpus

Authorizations

Authorization
string
header
required

Per-member, individually-revocable agent token minted via the device-code flow. Send as Authorization: Bearer agt_.... The scope array in each operation's security requirement names the IC scope the handler enforces.

Body

application/json
q
string
required

The query.

Maximum string length: 500
k
integer
default:10
Required range: 1 <= x <= 50
sources
enum<string>[]
Available options:
paper,
book
synthesize
boolean
default:false

When true, returns an LLM-synthesized grounded answer.

model
enum<string>

Only valid when synthesize=true.

Available options:
claude-haiku-4-5,
claude-sonnet-4-6,
claude-opus-4-7

Response

Retrieval results (or a synthesized answer).

Passthrough from the RAG funnel. /search returns { results, via }; /synthesize returns { q, k, model, answer, citations, retrieval_results, usage, via }.

results
object[]
answer
string
citations
object[]
via
string