---
title: "Semantic Search"
method: POST
path: "/teams/{team_id}/bots/{bot_id}/search"
---

# Semantic Search

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

## 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}/search`
- Auth: none declared

## Path parameters

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

## Request body

- Query
  - `query` string, required
  - `sourceId` string, nullable
  - `fileId` string, nullable
  - `use_glossary` boolean
  - `top_k` integer, nullable
  - `autocut` union
    - boolean
    - integer
  - `alpha` number, nullable: Hybrid search results can favor the keyword component or the semantic component. To change the relative weights of the keyword and vector components, set the alpha value in your query. An alpha of 1 is a pure semantic vector search. An alpha of 0 is a pure keyword search.
  - `tags` string[], nullable
  - `include_untagged` boolean

## Response `200`

Successful Response

- union
  - QuerySource[]
    - `title` string, nullable
    - `url` string, nullable
    - `fileId` string, nullable
    - `page` integer, nullable
    - `content` string, required
  - Error
    - `error` string, required

## 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)