Research
POST/research
Execute AI-powered research queries that search the web, analyze sources, and synthesize comprehensive answers. This endpoint always streams responses using Server-Sent Events (SSE).
Streaming Response:
- All responses are streamed using Server-Sent Events (
text/event-stream) - Real-time progress updates as research progresses through phases
Research Modes:
fast- Quick answers with minimal web searchesbalanced- Standard research with multiple iterations (default)
Use Cases:
- Answering complex questions with cited sources
- Synthesizing information from multiple web sources
- Research reports on specific topics
- Fact-checking and verification tasks
Request
Responses
- 200
- 400
- 401
- 500
- 503
SSE stream with research progress and results
Bad request - Invalid query or missing required fields
Unauthorized - Invalid or missing Bearer token
Internal server error
Service unavailable - Research service not configured