> ## Documentation Index
> Fetch the complete documentation index at: https://docs.co-mind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 7. Research

> Single-shot web search plus multi-step research sessions with iterative reasoning.

Two flavors: a synchronous single-shot search when you just want a list of hits, and a research session for a deeper investigation the platform orchestrates over time.

## Single-shot search

```bash theme={null}
curl -X POST {BASE_URL}/v1/researcher/search \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "EU AI Act enforcement dates 2026",
    "max_results": 5
  }'
```

```json theme={null}
{
  "results": [
    {
      "title": "EU AI Act — enforcement timeline",
      "url": "https://example.org/ai-act-timeline",
      "snippet": "General-purpose AI provisions apply from August 2025; high-risk AI system obligations phase in through 2026-2027..."
    }
  ]
}
```

## Multi-step research session

Start a session — the server orchestrates search, scrape, and synthesis over time:

```bash theme={null}
curl -X POST {BASE_URL}/v1/researcher/research \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"query": "Compare vector database options for on-prem RAG in 2026"}'
```

```json theme={null}
{
  "session_id": "res_sess_abc123",
  "status": "running"
}
```

Poll the session for progress:

```bash theme={null}
curl {BASE_URL}/v1/researcher/sessions/res_sess_abc123 \
  -H "Authorization: Bearer $PAT"
```

## Iterating on the result

Session controls let you refine an in-progress or finished session:

* `POST /v1/researcher/sessions/{id}/pause` — pause a running session
* `POST /v1/researcher/sessions/{id}/resume` — resume a paused session
* `POST /v1/researcher/sessions/{id}/critique` — critique the current results
* `POST /v1/researcher/sessions/{id}/improve` — improve the current results

See the [API Reference](/api-reference/introduction) for the full Researcher surface.

Next: [Translation →](/guides/api-walkthrough/translation)