---
title: "Create or update handover settings for a chatbot"
method: PUT
path: "/api/v1/handover-settings/{chatbotId}"
---

# Create or update handover settings for a chatbot

`PUT /api/v1/handover-settings/{chatbotId}`

## Request

- Base URL: `https://smartwebchat.eu`
- URL: `https://smartwebchat.eu/api/v1/handover-settings/{chatbotId}`
- Auth: HTTP bearer

## Path parameters

- `chatbotId` string, required

## Request body

- object
  - `enabled` boolean
  - `notificationEmail` string, nullable
  - `slackWebhookUrl` string, nullable
  - `businessHours` object: Keys: mo/di/mi/do/fr/sa/so → [startHour, endHour] oder null
  - `outsideHoursMessage` string
  - `autoHandoverKeywords` string[]: Each keyword must contain at least one non-whitespace character; an empty or blank keyword is rejected with 400.

## Response `200`

Upserted HandoverSettings

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid API key
- `404`: Chatbot not found
- `429`: Rate limit exceeded: 600 requests per minute per account across all /api/v1/ routes. Wait for the seconds given in Retry-After (60) and retry.

---

[API](https://skmtc.dev/smartwebchat/apis/smartwebchat-api.md) · [All operations](https://skmtc.dev/smartwebchat/apis/smartwebchat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smartwebchat/apis/smartwebchat-api/revisions/1b052502dacb?raw)