ReferenceDeep research

Start Research

Start a multi-agent deep research workflow.

Progress streams via SSE at /research/stream/{thread_id}. Charged as research.run.

POST
/api/v1/search/research/start

Authorization

ApiKeyAuth
x-api-key<token>

A platform key (ck_live_…). Mint one in the console under Settings → API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/search/research/start" \  -H "Content-Type: application/json" \  -d '{    "query": "Analyze the competitive landscape of AI coding assistants",    "allow_clarification": true,    "serviceId": "srv_123"  }'
{  "thread_id": "string",  "status": "string",  "message": "string",  "research_brief": "string",  "final_report": "string"}
Was this page helpful?
Report an issue