curl --request POST \
--url https://api.octen.ai/v1/research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tier": "standard",
"messages": [
{
"role": "user",
"content": "Progress and key milestones of the Artemis program"
}
]
}
'{
"type": "status",
"request_id": "20260403120000003ABCDE12345",
"object": "research.chunk",
"created": 1775361600,
"status": "Analyzing your question..."
}Deep Research API Reference
Generates a deep research report at the selected tier. The pro-visual tier also returns relevant images and videos.
Two-phase invocation
- Phase 1: the server generates a research plan. If the plan has no ambiguity, the server proceeds directly to research and streams the final report. If the plan is ambiguous, the
planevent carriesrequires_selection=truetogether with aplan_id, and the SSE stream ends there — waiting for the client to confirm. - Phase 2: call this endpoint again with the
plan_idandselections. The server loads the stored plan, applies the selections, and streams the final report.
Notes
- Phase 2 only inherits the stored
planviaplan_id. Other parameters are NOT inherited from Phase 1 — they must be supplied again in Phase 2, otherwise they fall back to defaults. messagesis required in both phases and should carry the same user question.
curl --request POST \
--url https://api.octen.ai/v1/research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tier": "standard",
"messages": [
{
"role": "user",
"content": "Progress and key milestones of the Artemis program"
}
]
}
'{
"type": "status",
"request_id": "20260403120000003ABCDE12345",
"object": "research.chunk",
"created": 1775361600,
"status": "Analyzing your question..."
}Authorizations
Body
Request body for the Deep Research API.
Skip the Research Brief stage and write the final report directly from raw search and analysis results.
Note: when enabled, no brief event is emitted. Clients can rebuild the citation index by accumulating the search_results of search_done events in the order they arrive (round-by-round / query-by-query / result-by-result) into a global index, then look up the corresponding url/title by the N in [^N].
Response
Successful Deep Research response. Always streamed as Server-Sent Events.
A streaming chunk of a Deep Research response.
The type of this streaming chunk. On the pro-visual tier, html_delta chunks stream an HTML version of the report after the report content completes, and a final html chunk marks the end of that stream.
status, plan, queries, search_done, analysis, brief, content, visual, html_delta, html, finish, usage, error Was this page helpful?