> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to DocsBot AI

The DocsBot AI connector lets your AI agent act in each user's DocsBot AI account. Each user connects their own DocsBot AI access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 54 tools.

**Authentication:** Bearer Token
**Categories:** AI, Customer Support
**Tools:** 54: 23 read, 23 write, 8 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=DOCSBOT)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the DocsBot AI connection

   In **AgentKit > Connections**, create a DocsBot AI connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'docsbot'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize DocsBot AI:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'docsbot_teams_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "docsbot"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize DocsBot AI:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="docsbot_teams_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their DocsBot AI credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'docsbot_bot_get',
  toolInput: {
    bot_id: '<bot_id>',
    team_id: '<team_id>',
  },
  connector: 'docsbot',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="docsbot_bot_get",
    tool_input={
        "bot_id": "<bot_id>",
        "team_id": "<team_id>",
    },
    connection_name="docsbot",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `docsbot_bot_get`

Get Bot · Read-only

Get one DocsBot bot by ID.
Returns its name, description, privacy, model, embedding model, custom prompt, language, widget settings, tools, retriever tags, status and usage counts.
Use List Bots to find bot IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_bot_reports_get`

Get Bot Reports · Read-only

Get a bot's monthly report and the list of months that have reports.
Returns the available report months and the report data for the selected month.
Use Get Bot Statistics for custom date ranges.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `month` (`string`, optional): Report month as YYYY-MM. Defaults to the latest report. Example: 2026-10.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_bot_stats_get`

Get Bot Statistics · Read-only

Get aggregated usage statistics for a bot over a number of days or a date range.
Returns question, rating, escalation, answer-rate, sentiment and topic counts with chart labels.
Use Get Bot Reports for monthly reports.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `end_date` (`string`, optional): End of the range (ISO 8601 or YYYY-MM-DD). Give with start_date. Ranges are capped at 365 days. Example: 2026-10-31.
- `start_date` (`string`, optional): Start of the range (ISO 8601 or YYYY-MM-DD). Give with end_date. Example: 2026-10-01.
- `time_delta` (`integer`, optional): Days to analyze, 0 to 365. Defaults to 30. Ignored when start_date and end_date are given. Example: 30.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_bots_list`

List Bots · Read-only

List the bots in a DocsBot team, with optional text search, privacy filter, sorting and paging.
Returns bots with id, name, description, privacy, model, status and usage counts; any paging option returns a paginated envelope with totalCount and totalPages.
Use Get Bot for one bot's full settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `order` (`string`, optional): Sort direction: asc or desc. Defaults to asc for name and desc otherwise. Example: desc. One of: `asc`, `desc`.
- `page` (`integer`, optional): Zero-based page number. Defaults to 0. Example: 1.
- `page_size` (`integer`, optional): Bots per page, 1 to 100. Defaults to 100 when paging. Example: 25.
- `privacy` (`string`, optional): Only bots with this privacy: public or private. Example: public. One of: `public`, `private`.
- `q` (`string`, optional): Case-insensitive text matched against bot name and description. Example: support.
- `sort` (`string`, optional): Sort order field: name, newest, ai-credits or conversations. Defaults to newest. Example: conversations. One of: `name`, `newest`, `ai-credits`, `conversations`.
- `view` (`string`, optional): full returns all bot settings; summary returns compact listing data. Example: summary. One of: `full`, `summary`.

Example input: `{"team_id":"<team_id>"}`

### `docsbot_conversation_get`

Get Conversation · Read-only

Get one conversation with its full message history.
Returns the conversation fields, history messages (Human and AI, with types and question IDs) and any ticket subject and content.
Use List Conversations to find conversation IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","team_id":"<team_id>"}`

### `docsbot_conversations_list`

List Conversations · Read-only

List a bot's Chat Agent conversations, newest first, without message history.
Returns conversations with id, title, summary, sentiment, channel, resolved and escalated status, metadata, and pagination.
Use Get Conversation for the full message history.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `page` (`integer`, optional): Zero-based page number. Defaults to 0. Example: 1.
- `per_page` (`integer`, optional): Conversations per page. Defaults to 25. Example: 25.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_document_fetch`

Fetch Document · Read-only

Fetch the full reconstructed text of one indexed document.
Returns the document content.
Use Semantic Search first to get the file ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `file_id` (`string`, required): File ID of the document, from a Semantic Search result. Example: doc_7f3a2b1c.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","file_id":"<file_id>","team_id":"<team_id>"}`

### `docsbot_leads_export`

Export Leads · Read-only

Export a bot's leads in a date range as a CSV file.
Returns a signed URL to download the CSV.
Use List Leads to read leads as JSON. Needs owner, admin or editor access.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `end_date` (`string`, required): End of the created date range (ISO date-time). Example: 2026-10-31T23:59:59.999Z.
- `start_date` (`string`, required): Start of the created date range (ISO date-time). Example: 2026-10-01T00:00:00.000Z.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","end_date":"<end_date>","start_date":"<start_date>","team_id":"<team_id>"}`

### `docsbot_leads_list`

List Leads · Read-only

List the leads a bot has captured, with optional date filters.
Returns leads with id (the conversation ID), metadata such as name and email, and timestamps.
Use Export Leads for a CSV file.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `end_date` (`string`, optional): Only leads created before this date or ISO date-time. Example: 2026-10-31T23:59:59.999Z.
- `page` (`integer`, optional): Zero-based page number. Defaults to 0. Example: 1.
- `per_page` (`integer`, optional): Leads per page. Defaults to 50. Example: 50.
- `start_date` (`string`, optional): Only leads created after this date or ISO date-time. Example: 2026-10-01T00:00:00.000Z.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_questions_list`

List Questions · Read-only

List the question history of a bot, filterable by rating, escalation, answerability, IP hash and date.
Returns questions with id, question, answer, sources, rating, escalation flag and timestamps.
Use List Conversations for whole Chat Agent threads.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `could_answer` (`boolean`, optional): Only questions the bot could (true) or could not (false) answer. Example: false.
- `end_date` (`string`, optional): Only questions before this date or ISO date-time. Example: 2026-10-31.
- `escalated` (`boolean`, optional): Only escalated (true) or non-escalated (false) questions. Example: true.
- `ip` (`string`, optional): Only questions from this SHA-256 IP hash. Example: 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08.
- `page` (`integer`, optional): Zero-based page number. Defaults to 0. Example: 1.
- `per_page` (`integer`, optional): Questions per page. Defaults to 50. Example: 50.
- `rating` (`integer`, optional): Only questions with this rating: -1 (down), 0 (neutral) or 1 (up). Example: 1. One of: `-1`, `0`, `1`.
- `start_date` (`string`, optional): Only questions after this date or ISO date-time. Example: 2026-10-01.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_research_job_get`

Get Research Job · Read-only

Get a deep research job's status and result.
Returns its status, any clarifying questions and, when completed, the research response.
Use List Research Jobs to find job IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `job_id` (`string`, required): Deep research job ID, returned by Start Deep Research or List Research Jobs. Example: rj_8Kx2mQ4pLz.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","job_id":"<job_id>","team_id":"<team_id>"}`

### `docsbot_research_jobs_list`

List Research Jobs · Read-only

List a bot's deep research jobs.
Returns jobs with job ID, status, title, question and timestamps, and pagination.
Use Get Research Job for one job's result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `page` (`integer`, optional): Zero-based page number. Defaults to 0. Example: 1.
- `per_page` (`integer`, optional): Jobs per page. Defaults to 25. Example: 25.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_semantic_search`

Semantic Search · Read-only

Search a bot's indexed content without generating an answer.
Returns matching chunks with title, url, page and content.
Use Chat with Agent for an AI answer. Use Fetch Document for a whole file.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `query` (`string`, required): Search text. Example: reset password.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `alpha` (`number`, optional): Hybrid weighting: 0 is pure keyword, 1 is pure semantic. Defaults to 0.5. Example: 0.5.
- `include_untagged` (`boolean`, optional): Also return untagged chunks when tags is set. Defaults to true. Example: true.
- `source_id` (`string`, optional): Only search this source. Example: qGDSDhbdxtqmifTZQrYs.
- `tags` (`array`, optional): Only return chunks with these source tag keys. Example: ["billing"].
- `top_k` (`integer`, optional): Number of results. Defaults to 5. Example: 5.
- `use_glossary` (`boolean`, optional): Apply the bot's glossary to the query. Example: false.

Example input: `{"bot_id":"<bot_id>","query":"<query>","team_id":"<team_id>"}`

### `docsbot_source_download_get`

Get Source Download URL · Read-only

Get a signed download URL for a single-file source's uploaded file.
Returns a signed url and a suggested filename.
Use Get Source File Download URL for one file of a multi-file source.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `source_id` (`string`, required): Source ID. Get it from List Sources. Example: qGDSDhbdxtqmifTZQrYs.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","source_id":"<source_id>","team_id":"<team_id>"}`

### `docsbot_source_file_download_get`

Get Source File Download URL · Read-only

Get a signed download URL for one file in a multi-file document source.
Returns a signed url and a suggested filename.
Use Get Source to read the file paths.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `file_name` (`string`, required): Relative path of the file from the source's files list (p), or its base name. Example: guides/setup.pdf.
- `source_id` (`string`, required): Source ID. Get it from List Sources. Example: qGDSDhbdxtqmifTZQrYs.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","file_name":"<file_name>","source_id":"<source_id>","team_id":"<team_id>"}`

### `docsbot_source_get`

Get Source · Read-only

Get one training source by ID.
Returns its type, title, url, status, page and chunk counts, tags, schedule, indexed URLs, FAQs and warnings.
Use List Sources to find source IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `source_id` (`string`, required): Source ID. Get it from List Sources. Example: qGDSDhbdxtqmifTZQrYs.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","source_id":"<source_id>","team_id":"<team_id>"}`

### `docsbot_source_tag_counts_get`

Get Source Tag Counts · Read-only

Count a bot's sources per configured tag key, plus untagged sources.
Returns a count for each tag key and an untagged count.
Use List Sources with tags to see the sources. Needs retriever tags (Standard plan and above).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_sources_list`

List Sources · Read-only

List a bot's training sources, optionally filtered by tag.
Returns sources with id, type, title, url, status, page and chunk counts, and a pagination object.
Use Get Source for one source's indexed URLs and warnings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `limit` (`integer`, optional): Sources per page. Defaults to 100. Example: 50.
- `page` (`integer`, optional): Zero-based page number. Defaults to 0. Example: 1.
- `tags` (`string`, optional): Comma-separated tag keys; returns sources with any of them. Use __untagged__ for sources with no tags. Standard plan and above. Example: billing,support.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_team_get`

Get Team · Read-only

Get one DocsBot team by ID.
Returns its name, status, plan and limits, bot, source, page and chunk counts, AI credits used this period and a masked OpenAI key preview.
Use List Teams to find team IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"team_id":"<team_id>"}`

### `docsbot_team_members_list`

List Team Members · Read-only

List the members of a DocsBot team.
Returns each member's user ID (uid), display name, email, avatar URL and role (owner, admin or member).
Use the uid with Update Team Member Role or Remove Team Member.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"team_id":"<team_id>"}`

### `docsbot_teams_list`

List Teams · Read-only

List every DocsBot team the API key's user belongs to.
Returns team summaries with id, name, status, plan limits, bot count and usage counts.
Use Get Team for one team's full details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `docsbot_webhook_get`

Get Webhook · Read-only

Get one webhook on a bot.
Returns its target URL, events, label, status and expiration date.
Use List Webhooks to find webhook IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `webhook_id` (`string`, required): Webhook ID. Get it from List Webhooks. Example: abc123.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>","webhook_id":"<webhook_id>"}`

### `docsbot_webhooks_list`

List Webhooks · Read-only

List the webhooks registered on a bot.
Returns webhooks with id, target URL, events, label, status and expiration date.
Use Get Webhook for one webhook.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_answer_rate`

Rate Answer · Write

Rate a bot answer positive, negative or neutral.
Returns a success message; the rating appears in question history and fires conversation.rated webhooks.
Use the answer id from Chat with Agent or Chat.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `answer_id` (`string`, required): Answer (question) ID: the id of a lookup_answer event from Chat Agent, or the id returned by Chat. Example: FHSGF2524i25xbZRyySL.
- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `rating` (`integer`, required): 1 for a positive rating, -1 for negative, 0 to reset. Example: 1. One of: `-1`, `0`, `1`.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"answer_id":"<answer_id>","bot_id":"<bot_id>","rating":1,"team_id":"<team_id>"}`

### `docsbot_answer_support_log`

Log Support Request · Write

Record that a user clicked through to support after an answer, for statistics.
Returns a success message.
Use Escalate Conversation for confirmed Chat Agent escalations.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `answer_id` (`string`, required): Answer (question) ID: the id of a lookup_answer event from Chat Agent, or the id returned by Chat. Example: FHSGF2524i25xbZRyySL.
- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"answer_id":"<answer_id>","bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_bot_create`

Create Bot · Write

Create a new bot in a DocsBot team, optionally as a copy of an existing bot.
Returns the new bot with its id and status.
Use Create Source next to train it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `description` (`string`, required): Bot description, shown by default in embeds and share links. Example: Ask me anything about Acme..
- `language` (`string`, required): Bot language code, for example en or jp. Example: en.
- `name` (`string`, required): Bot name, shown publicly. Example: Acme Help Bot.
- `privacy` (`string`, required): public or private. Private bots need a Bearer token for chat calls. Example: public. One of: `public`, `private`.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `copy_from` (`string`, optional): ID of an existing bot in the team to copy, including its sources. Example: iADcTdrl7R51JiTjrWKy.
- `embedding_model` (`string`, optional): Embedding model, depending on plan: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002, embed-multilingual-v3.0 or embed-v4.0. Must match the source bot when copying. Example: text-embedding-3-large.
- `model` (`string`, optional): AI model: gpt-6-luna (default), gpt-6.1-terra, gpt-6.1-sol or gpt-6-astra. Example: gpt-6-luna.
- `retriever_tags` (`array`, optional): Source tag vocabulary for targeted retrieval (Standard plan and above). Each entry has a key (lowercase slug) and a description. Example: [{"key": "billing", "description": "Billing and invoices"}].

Example input: `{"description":"<description>","language":"<language>","name":"<name>","privacy":"public","team_id":"<team_id>"}`

### `docsbot_bot_update`

Update Bot · Write

Update a DocsBot bot's settings, such as name, prompt, privacy, model, widget appearance, tools or retriever tags.
Returns the updated bot. Fields left out are not changed.
Use Get Bot to read the current settings. Widget changes can take up to 5 minutes to appear.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `alignment` (`string`, optional): Side of the page for the chat bubble: left or right. Example: right. One of: `left`, `right`.
- `allowed_domains` (`array`, optional): Hostnames the widget may be embedded on. An empty list allows all. Example: ["docs.acme.com"].
- `color` (`string`, optional): Widget color in hex. Example: #1E40AF.
- `custom_prompt` (`string`, optional): Custom prompt instructions (Standard plan and higher). Example: Always answer in a friendly tone..
- `description` (`string`, optional): Bot description, shown in embeds and share links. Example: Ask me anything about Acme..
- `hide_sources` (`boolean`, optional): Hide answer sources in the widget. Example: false.
- `labels` (`object`, optional): Widget label copy, keyed by label name, for example firstMessage or inputPlaceholder. Example: {"firstMessage": "Hi! How can I help?"}.
- `language` (`string`, optional): Bot language code, for example en. Example: en.
- `model` (`string`, optional): AI model: gpt-6-luna, gpt-6.1-terra, gpt-6.1-sol or gpt-6-astra. Example: gpt-6.1-sol.
- `name` (`string`, optional): Bot name, shown publicly. Example: Acme Help Bot.
- `privacy` (`string`, optional): public or private. Example: private. One of: `public`, `private`.
- `retriever_tags` (`array`, optional): Source tag vocabulary (Standard plan and above). Each entry has a key and description. Removing a key also removes it from every source. Example: [{"key": "billing", "description": "Billing and invoices"}].
- `show_button_label` (`string`, optional): Text for the support link button. Example: Contact support.
- `show_copy_button` (`boolean`, optional): Show a copy-to-clipboard button after answers. Example: true.
- `support_link` (`string`, optional): Link shown after bot replies. An empty string disables it. Example: https://acme.com/support.
- `tools` (`object`, optional): Agent tool configuration: calendly, calcom and tidycal entries (enabled, instructions, url) and customButtons. Example: {"calendly": {"enabled": true, "instructions": "Offer a demo call", "url": "https://calendly.com/acme/demo"}}.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_chat`

Chat (Legacy) · Write

Ask a bot one question with optional history (stateless legacy chat API).
Returns the answer, sources, question id and whether it could answer.
Use Chat with Agent for stateful conversations with tools. Spends AI credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `question` (`string`, required): The question to ask, 2 to 500 characters. Example: How do I reset my password?.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `context_items` (`integer`, optional): Number of sources to look up. Defaults to 5. Example: 5.
- `format` (`string`, optional): Answer format: markdown (default) or text. Example: markdown. One of: `markdown`, `text`.
- `full_source` (`boolean`, optional): Return the full source content with each source. Example: false.
- `history` (`array`, optional): Earlier turns as [question, answer] pairs, for follow-up questions. Example: [["What is Acme?", "Acme is a support platform."]].
- `metadata` (`object`, optional): User details saved with the question. Example: {"email": "jane@example.com"}.
- `testing` (`boolean`, optional): Mark as a test question. Example: true.

Example input: `{"bot_id":"<bot_id>","question":"<question>","team_id":"<team_id>"}`

### `docsbot_chat_agent`

Chat with Agent · Write

Send a message to a bot's Chat Agent in a stateful conversation and get its reply (non-streaming).
Returns a list of events, including lookup_answer with the answer, sources and question id, and any support_escalation or tool events.
Use the same conversation_id for follow-ups. Use Semantic Search to fetch sources without an answer. Spends AI credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): UUID for the conversation. Reuse it to continue a conversation; send a new UUID to start one. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `question` (`string`, required): The user's message, 2 to 500 characters (up to about 32,000 when authenticated). Example: How do I reset my password?.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `context_items` (`integer`, optional): Number of sources to look up. Defaults to 5. Example: 5.
- `default_language` (`string`, optional): Locale to use when the conversation language is unclear, for example en or en-US. Example: en.
- `document_retriever` (`boolean`, optional): Enable the documentation search tool. Defaults to true. Example: true.
- `followup_rating` (`boolean`, optional): Enable the follow-up rating question tool. Example: false.
- `format` (`string`, optional): Answer format: markdown (default) or text. Example: markdown. One of: `markdown`, `text`.
- `human_escalation` (`boolean`, optional): Enable the human escalation detection tool. Example: false.
- `image_urls` (`array`, optional): Image URLs to include as context (supported models only). Example: ["https://example.com/screenshot.png"].
- `metadata` (`object`, optional): User details saved with the conversation; name, email and referrer show in logs. Example: {"name": "Jane Doe", "email": "jane@example.com"}.
- `model` (`string`, optional): Override the bot's model for this request. Example: gpt-6.1-sol.
- `testing` (`boolean`, optional): Mark the conversation as a test so it is excluded from stats. Example: true.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","question":"<question>","team_id":"<team_id>"}`

### `docsbot_conversation_escalate`

Escalate Conversation · Write

Log a confirmed human-support escalation on a conversation.
Returns a success message; sets escalated to handled and fires conversation.escalated webhooks.
Call it after the user confirms a support_escalation from Chat with Agent.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","team_id":"<team_id>"}`

### `docsbot_conversation_lead_capture`

Capture Lead · Write

Save a lead from a conversation and merge its details into the conversation metadata.
Returns a success message and fires lead.created webhooks.
Use List Leads to read captured leads.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `metadata` (`object`, required): Lead details, such as name, email and company. Merged into the conversation metadata. Example: {"name": "Jane Doe", "email": "jane@example.com", "company": "Acme Corp"}.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `full_change` (`boolean`, optional): true replaces all metadata; false (default) merges into it. Example: false.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","metadata":{"name":"Jane Doe","email":"jane@example.com","company":"Acme Corp"},"team_id":"<team_id>"}`

### `docsbot_conversation_metadata_update`

Update Conversation Metadata · Write

Update the user metadata stored on a conversation, merging by default.
Returns a success message.
Use Capture Lead to also save the user as a lead.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `metadata` (`object`, required): Metadata to store on the conversation, such as name and email. Example: {"name": "Jane Doe", "plan": "pro"}.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `full_change` (`boolean`, optional): true replaces all metadata; false (default) merges into it. Example: false.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","metadata":{"name":"Jane Doe","plan":"pro"},"team_id":"<team_id>"}`

### `docsbot_conversation_summarize`

Summarize Conversation · Write

Generate (or return the cached) summary of a conversation.
Returns a title, summary text and sentiment.
Use Generate Support Ticket for a help-desk ticket instead. May spend AI credits.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","team_id":"<team_id>"}`

### `docsbot_conversation_ticket_generate`

Generate Support Ticket · Write

Generate a structured support ticket from a conversation's history.
Returns a ticket subject and detailed content for a help desk.
Use Summarize Conversation for a short summary. May spend AI credits.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","team_id":"<team_id>"}`

### `docsbot_research_continue`

Continue Deep Research · Write

Answer a deep research job's clarifying questions so it continues.
Returns the job with its new status.
Use Get Research Job to poll until it completes.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `answers` (`string`, required): Answers to the job's clarifying questions. Example: Focus on EU customers and annual plans..
- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `job_id` (`string`, required): Deep research job ID, returned by Start Deep Research or List Research Jobs. Example: rj_8Kx2mQ4pLz.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `model` (`string`, optional): Override the research model for this job. Example: gpt-6.1-sol.
- `web_search` (`boolean`, optional): Override web search. Example: true.

Example input: `{"answers":"<answers>","bot_id":"<bot_id>","job_id":"<job_id>","team_id":"<team_id>"}`

### `docsbot_research_start`

Start Deep Research · Write

Start a deep research job that searches a bot's docs (and optionally the web) to answer a complex question.
Returns the job ID and status; the job may ask clarifying questions.
Use Get Research Job to poll and Continue Deep Research to answer clarifications. Spends AI credits.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `question` (`string`, required): The research question or task. Example: Compare our refund policy with industry norms..
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `code_interpreter` (`boolean`, optional): Enable the code interpreter. Example: false.
- `docs_search` (`boolean`, optional): Search the bot's documentation. Defaults to true. Example: true.
- `metadata` (`object`, optional): User details; name and email are recognized. Example: {"email": "jane@example.com"}.
- `model` (`string`, optional): Research model tier: gpt-6-luna (default), gpt-6.1-terra, gpt-6.1-sol or gpt-6-astra. Example: gpt-6-luna. One of: `gpt-6-luna`, `gpt-6.1-terra`, `gpt-6.1-sol`, `gpt-6-astra`.
- `question_history` (`boolean`, optional): Search the bot's question history. Example: false.
- `tags` (`array`, optional): Only search documentation chunks with these source tags. Example: ["billing"].
- `web_search` (`boolean`, optional): Enable web search. Example: false.

Example input: `{"bot_id":"<bot_id>","question":"<question>","team_id":"<team_id>"}`

### `docsbot_source_create`

Create Source · Write

Add a training source to a bot, such as a web page, sitemap, YouTube video, RSS feed or Q&A pairs.
Returns the new source with status pending; it indexes in the background.
Use Get Source to check progress. File uploads are not supported by this tool.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `type` (`string`, required): Source type: url, sitemap, youtube, rss or qa work with this tool directly; document, wp, urls and csv need a file already uploaded to DocsBot storage. Example: url. One of: `url`, `sitemap`, `youtube`, `rss`, `qa`, `document`, `wp`, `urls`, `csv`.
- `faqs` (`array`, optional): Question and answer pairs. Required for qa type. Example: [{"question": "What is Acme?", "answer": "Acme is a support platform."}].
- `file` (`string`, optional): Storage path of an already uploaded file, for file-based types. Example: teams/FOX1XkWo8VMx3hp6Zjkb/bots/SQMV36O8xi43xbZRzYLy/uploads/report.pdf.
- `ocr` (`boolean`, optional): Advanced layout-aware document parsing (Standard plan and higher; 2 AI credits per page). Example: false.
- `process_images` (`boolean`, optional): Describe images during ingest (Standard plan and higher). Example: false.
- `schedule_interval` (`string`, optional): Refresh schedule: daily, weekly, monthly or none (default), depending on plan. Example: weekly. One of: `daily`, `weekly`, `monthly`, `none`.
- `tags` (`array`, optional): Tag keys to assign, from the bot's retriever tags (Standard plan and higher). Example: ["billing"].
- `title` (`string`, optional): Source title. Required for document type; a dashboard label for other types. Example: Acme docs.
- `url` (`string`, optional): Source URL. Required for url, sitemap, youtube and rss types. Example: https://docs.acme.com/getting-started.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>","type":"url"}`

### `docsbot_source_retry`

Retry Source · Write

Retry indexing a source whose status is failed.
Returns the source with its new status.
Use Get Source to check its status first.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `source_id` (`string`, required): Source ID. Get it from List Sources. Example: qGDSDhbdxtqmifTZQrYs.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","source_id":"<source_id>","team_id":"<team_id>"}`

### `docsbot_source_tags_update`

Update Source Tags · Write

Set, add or remove tags on one or more sources.
Returns the updated sources' tags.
Provide set, or add and/or remove. Tag keys must exist in the bot's retriever tags (Standard plan and higher).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `source_ids` (`array`, required): IDs of the sources to update, up to 100. Example: ["qGDSDhbdxtqmifTZQrYs"].
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `add` (`array`, optional): Tag keys to add. Ignored when set is given. Example: ["billing"].
- `remove` (`array`, optional): Tag keys to remove. Ignored when set is given. Example: ["support"].
- `set` (`array`, optional): Replace the tags with exactly this list. Use [] to clear all tags. Example: ["billing", "support"].

Example input: `{"bot_id":"<bot_id>","source_ids":["qGDSDhbdxtqmifTZQrYs"],"team_id":"<team_id>"}`

### `docsbot_source_title_update`

Update Source Title · Write

Change a source's dashboard title without reindexing.
Returns the updated source.
Only URL list, website, sitemap and multi-file document sources support this; others return 409.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `source_id` (`string`, required): Source ID. Get it from List Sources. Example: qGDSDhbdxtqmifTZQrYs.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `title` (`string`, required): New dashboard title. An empty string clears it. Example: Partner documentation URLs.

Example input: `{"bot_id":"<bot_id>","source_id":"<source_id>","team_id":"<team_id>","title":"<title>"}`

### `docsbot_team_create`

Create Team · Write

Create a new DocsBot team owned by the API key's user.
Returns the new team with its id, name, status and plan.
Use Create Bot next to add a bot to the team.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, optional): Team name. If omitted, DocsBot names the team from the user's profile or email. Example: Acme Support.

Example input: `{}`

### `docsbot_team_invite_send`

Invite Team Member · Write

Send an email invitation to join a DocsBot team.
Returns a confirmation message. The invitee receives an email.
Use Remove Team Member with remove_user_email to revoke the invite.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invite_email` (`string`, required): Email address of the person to invite. Example: newuser@example.com.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `role` (`string`, optional): Role the invited user gets on joining: admin or member. Example: member. One of: `admin`, `member`.

Example input: `{"invite_email":"<invite_email>","team_id":"<team_id>"}`

### `docsbot_team_member_role_update`

Update Team Member Role · Write

Change a team member's role to admin or member.
Returns the updated member list.
Use List Team Members to find the member's uid.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `member_id` (`string`, required): User ID (uid) of the member to change. Get it from List Team Members. Example: u8Hq2LmN3pR5sT7v.
- `role` (`string`, required): New role for the member: admin or member. Example: admin. One of: `admin`, `member`.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"member_id":"<member_id>","role":"admin","team_id":"<team_id>"}`

### `docsbot_team_update`

Update Team · Write

Rename a DocsBot team.
Returns the updated team.
Use Get Team to read the current settings.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `name` (`string`, required): New team name. Example: Acme Support.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"name":"<name>","team_id":"<team_id>"}`

### `docsbot_webhook_create`

Create Webhook · Write

Subscribe a URL to a bot's lead, deep research, escalation or rating events.
Returns the new webhook with its id and status.
Use List Webhooks to see existing subscriptions.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `events` (`array`, required): Events to subscribe to: lead.created, deep_research.done, conversation.escalated, conversation.rated. Example: ["lead.created", "conversation.escalated"].
- `target_url` (`string`, required): HTTPS URL that receives the webhook POSTs. Example: https://example.com/webhooks/docsbot.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `expiration_date` (`string`, optional): ISO date-time after which the webhook stops. Example: 2027-03-15T00:00:00.000Z.
- `label` (`string`, optional): Label to identify the webhook. Example: CRM sync.

Example input: `{"bot_id":"<bot_id>","events":["lead.created","conversation.escalated"],"target_url":"<target_url>","team_id":"<team_id>"}`

### `docsbot_webhook_update`

Update Webhook · Write

Update a webhook's status, target URL, label or expiration date.
Returns the updated webhook.
Use Get Webhook to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `webhook_id` (`string`, required): Webhook ID. Get it from List Webhooks. Example: abc123.
- `expiration_date` (`string`, optional): New ISO expiration date-time. Example: 2027-03-15T00:00:00.000Z.
- `label` (`string`, optional): New label. Example: CRM sync.
- `status` (`string`, optional): Webhook status, for example active (as returned by Get Webhook). Example: active.
- `target_url` (`string`, optional): New HTTPS target URL. Example: https://example.com/webhooks/docsbot.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>","webhook_id":"<webhook_id>"}`

### `docsbot_bot_delete`

Delete Bot · Destructive

Permanently delete a DocsBot bot and its sources.
Returns a success message.
Use List Bots to find the bot ID first.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>"}`

### `docsbot_conversation_delete`

Delete Conversation · Destructive

Delete a conversation from a bot's history.
Returns a success message.
Use List Conversations to find the conversation ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `conversation_id` (`string`, required): Conversation ID (the UUID used with Chat Agent). Get it from List Conversations. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","conversation_id":"<conversation_id>","team_id":"<team_id>"}`

### `docsbot_lead_delete`

Delete Lead · Destructive

Delete one lead record from a bot.
Returns a success message.
Use List Leads to find the lead ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `lead_id` (`string`, required): Lead ID (the conversation ID the lead came from). Get it from List Leads. Example: 3f6c1d2e-8a4b-4c1d-9e7f-2a1b3c4d5e6f.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","lead_id":"<lead_id>","team_id":"<team_id>"}`

### `docsbot_question_delete`

Delete Question · Destructive

Delete one question from a bot's question history.
Returns a success message.
Use List Questions to find the question ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `question_id` (`string`, required): Question ID, from List Questions or a Chat Agent lookup_answer event. Example: FHSGF2524i25xbZRyySL.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","question_id":"<question_id>","team_id":"<team_id>"}`

### `docsbot_research_cancel`

Cancel Deep Research · Destructive

Cancel a running deep research job.
Returns the cancelled job.
Use List Research Jobs to find running jobs.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `job_id` (`string`, required): Deep research job ID, returned by Start Deep Research or List Research Jobs. Example: rj_8Kx2mQ4pLz.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","job_id":"<job_id>","team_id":"<team_id>"}`

### `docsbot_source_delete`

Delete Source · Destructive

Delete a training source from a bot. It may still appear in answers for a few minutes.
Returns a success message.
Use List Sources to find the source ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `source_id` (`string`, required): Source ID. Get it from List Sources. Example: qGDSDhbdxtqmifTZQrYs.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.

Example input: `{"bot_id":"<bot_id>","source_id":"<source_id>","team_id":"<team_id>"}`

### `docsbot_team_member_remove`

Remove Team Member · Destructive

Remove a member from a DocsBot team, or revoke an outstanding invite by email.
Returns a success message.
Provide remove_user_id for a member or remove_user_email for an invite.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `remove_user_email` (`string`, optional): Email address of an outstanding invite to revoke. Provide this or remove_user_id. Example: newuser@example.com.
- `remove_user_id` (`string`, optional): User ID (uid) of the member to remove from the team. Provide this or remove_user_email. Example: u8Hq2LmN3pR5sT7v.

Example input: `{"team_id":"<team_id>"}`

### `docsbot_webhook_delete`

Delete Webhook · Destructive

Delete a webhook subscription from a bot.
Returns a success message with the webhook ID.
Use List Webhooks to find the webhook ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bot_id` (`string`, required): DocsBot bot ID. Get it from List Bots. Example: SQMV36O8xi43xbZRzYLy.
- `team_id` (`string`, required): DocsBot team ID. Find it on the API page of the DocsBot dashboard or with List Teams. Example: FOX1XkWo8VMx3hp6Zjkb.
- `webhook_id` (`string`, required): Webhook ID. Get it from List Webhooks. Example: abc123.

Example input: `{"bot_id":"<bot_id>","team_id":"<team_id>","webhook_id":"<webhook_id>"}`

## Related

Other AI connectors ([all 216](/agentkit/connectors/?category=ai)):

- [Chorus](/agentkit/connectors/chorus/): Scalekit connector, Username and password, 9 tools
- [Gong](/agentkit/connectors/gong/): Scalekit connector, OAuth, 69 tools
- [Jiminny](/agentkit/connectors/jiminny/): Scalekit connector, Access token, 27 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
