v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB
Research Agent

Research Agent

Execute a research query with AI-powered analysis and real-time data. Returns a streaming response via Server-Sent Events.

post/v1/research-agent

Request body

chat_idstring nullable

Provide a previous chat ID to continue a conversation.

from_checkpoint_idstring nullable

Resume or edit a conversation from a specific checkpoint.

messagestring required

Your research question or request.

model_name'base' | 'pro'

Available models for execution.

persistence_mode'enabled' | 'disabled'

Controls whether conversation history is saved.

research_effort'lite' | 'standard' required

Controls the depth and thoroughness of the research.

structured_output_schemaobject nullable

JSON Schema for structured data extraction from the research results.

Example request

{
  "tools_configs": {
    "search": {
      "query_filters": {
        "reporting_entities": [
          "228D42"
        ]
      }
    }
  }
}

Response

Streaming SSE response with research results.

chat_idstring required

Identifier for this conversation.