---
title: "Start handover"
method: POST
path: "/handover/start/{bot_id}"
tags: ["Handover"]
---

# Start handover

`POST /handover/start/{bot_id}`

This will mute the bot for a specific user and define the client session as escalated to a human

## Path parameters

- `bot_id` string, required

## Request body

- HandoverStart
  - `client_id` string, required — ID of the user as returned by the /dialog endpoint

## Response `200`

successful operation

- Bot
  - `__v` integer
  - `updatedAt` string
  - `createdAt` string
  - `confidence_threshold` integer
  - `slave_bots` string[]
  - `graph` object
  - `lang` string
  - `name` string
  - `user_id` string
  - `_id` string
  - `is_master_bot` boolean
  - `collaborators` string
  - `confidence` integer
  - `type` string
  - `is_shared` boolean
  - `mute` boolean
  - `is_public` boolean
  - `is_template` boolean

## Other responses

- `400` — Invalid ID supplied
- `404` — bot not found

---

[API](https://skmtc.net/smartly/apis/smartly-ai-apis.md) · [All operations](https://skmtc.net/smartly/apis/smartly-ai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartly/smartly-ai-apis/revisions/1e26909d86c9/schema)