Skip to main content
POST
Start research asynchronously

Authorizations

X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Body

application/json
query
string
required

Research question

Required string length: 1 - 10000
Example:

"Compare long-duration energy storage approaches"

mode
enum<string>

Depth of research. Omitted selects deep.

Available options:
deep,
max
Example:

"deep"

stream
boolean

Emit report text through synthesis_delta events as it is written

output_language
string

BCP 47 language tag for the report

Example:

"ja"

domain_filter
object

Domain preferences. Each list accepts at most 150 entries.

prior_run_id
string

Seed this run with a completed report and its evidence

session_id
string<uuid>

Continue a research session. Mutually exclusive with prior_run_id.

Response

Research queued. Poll by research_run_id for status and results.

research_run_id
string<uuid>
required
error
object | null
required

Error details. Null if successful.