ReferenceWeb and research

Start Web and Research

Prepare a web & research session.

Calling start alone does not run the agent — connect to websocket_url to trigger it. Clarifying answers are sent over the same WebSocket.

POST
/api/v1/search/agent/web-and-research

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

curl -X POST "https://example.com/api/v1/search/agent/web-and-research" \  -H "Content-Type: application/json" \  -d '{    "prompt": "What are the main trends in enterprise AI adoption for healthcare in 2026?",    "llm_model": "claude sonnet 4.6",    "live_url": true,    "proxy": false  }'
{  "success": true,  "message": "string",  "thread_id": "string",  "list_id": "string",  "websocket_url": "string",  "status": "string"}
Was this page helpful?
Report an issue