---
title: "Start Deep Research"
method: POST
path: "/teams/{team_id}/bots/{bot_id}/research"
---

# Start Deep Research

`POST /teams/{team_id}/bots/{bot_id}/research`

## Request

- Base URL: `https://api.docsbot.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.docsbot.ai/teams/{team_id}/bots/{bot_id}/research`
- Auth: none declared

## Path parameters

- `team_id` string, required
- `bot_id` string, required

## Request body

- ResearchStartRequest
  - `question` string, required
  - `model` 'gpt-6-astra' | 'gpt-6.1-sol' | 'gpt-6-sol' | 'gpt-6-luna' | 'gpt-5.4-mini' | 'gpt-5.5' | 'gpt-5.6-sol' | 'gpt-5.6-luna' | 'o3' | 'o4-mini': Deep research model tier. gpt-6-luna is the default efficient option; gpt-5.4-mini remains available for legacy requests; gpt-6.1-sol is balanced; gpt-6-astra is most capable. Legacy values o3/o4-mini are accepted as aliases.
  - `web_search` boolean: Enable web search tool for deep research
  - `code_interpreter` boolean: Enable code interpreter tool
  - `docs_search` boolean: Enable documentation search tool (default true)
  - `question_history` boolean: Enable question history tool for firestore search (default false)
  - `metadata` object, nullable: Optional user metadata. Keys 'name' and 'email' are recognized.
  - `tags` string[], nullable
  - `include_untagged` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/docsbot/apis/docsbot-chat-api.md) · [All operations](https://skmtc.dev/docsbot/apis/docsbot-chat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/docsbot/apis/docsbot-chat-api/revisions/336b782b49d5?raw)