Skip to main content
POST
Run deep research

Authorizations

Authorization
string
header
required

An Originalis API key: Authorization: Bearer ak_...

Body

application/json

Submit a research question for a deep-research run.

query
string
required

The research question, e.g. 'Map the warehouse-automation competitive landscape and sizing for mid-market 3PLs.'

Required string length: 1 - 20000
idempotency_key
string
required

Required. Reuse the same key to safely retry — you get the same run back, never a second spend. Use a fresh key for a genuinely new question.

Required string length: 1 - 512

Response

Successful Response

Accepted research submission (HTTP 202).

research_id
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed
status_url
string
required

Poll GET here until status is 'succeeded' or 'failed'. Runs take minutes (up to 30) — poll with generous backoff.

result_url
string
required
as_of
string<date-time>
required