---
title: "Update Bot Widget Setting"
method: PUT
path: "/api/bot/bot-widget-setting"
tags: ["Bot"]
---

# Update Bot Widget Setting

`PUT /api/bot/bot-widget-setting`

Update bot widget setting.

## Request body

- BotWidgetSettingSchema — Bot widget setting schema.
  - `bot_id` string, uuid, required — Unique identifier for the bot.
  - `domain` string[], nullable — List of domains associated with the bot.
  - `display_name` string, nullable — Display name for the bot widget.
  - `initial_message` string, nullable — Initial message for the bot widget.
  - `suggest_messages` string[], nullable — List of suggested messages for the bot widget.
  - `theme` string, nullable — Theme for the bot widget.
  - `bot_avatar_url` string, nullable — URL for the bot's avatar.
  - `chat_icon_url` string, nullable — URL for the chat icon.
  - `chat_bubble_button_color` string, nullable — Color for the chat bubble button.
  - `chat_message_color` string, nullable — Color for the chat messages.
  - `align_chat_bubble_button` string, nullable — Alignment for the chat bubble button.
  - `auto_show_initial_message_after` number, nullable — Auto-show initial message duration.
  - `is_circle_icon` boolean, nullable — Flag for using a circle icon.
  - `buble_text` string, nullable — Text for the chat bubble.
  - `role` string, nullable — Role associated with the bot.
  - `is_disable_powered` boolean, nullable — Flag for disabling the powered by message.

## Response `200`

Successful Response

- BotWidgetSettingSchema — Bot widget setting schema.
  - `bot_id` string, uuid, required — Unique identifier for the bot.
  - `domain` string[], nullable — List of domains associated with the bot.
  - `display_name` string, nullable — Display name for the bot widget.
  - `initial_message` string, nullable — Initial message for the bot widget.
  - `suggest_messages` string[], nullable — List of suggested messages for the bot widget.
  - `theme` string, nullable — Theme for the bot widget.
  - `bot_avatar_url` string, nullable — URL for the bot's avatar.
  - `chat_icon_url` string, nullable — URL for the chat icon.
  - `chat_bubble_button_color` string, nullable — Color for the chat bubble button.
  - `chat_message_color` string, nullable — Color for the chat messages.
  - `align_chat_bubble_button` string, nullable — Alignment for the chat bubble button.
  - `auto_show_initial_message_after` number, nullable — Auto-show initial message duration.
  - `is_circle_icon` boolean, nullable — Flag for using a circle icon.
  - `buble_text` string, nullable — Text for the chat bubble.
  - `role` string, nullable — Role associated with the bot.
  - `is_disable_powered` boolean, nullable — Flag for disabling the powered by message.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/chat-fly/apis/chatfly-backend-application.md) · [All operations](https://skmtc.net/chat-fly/apis/chatfly-backend-application/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chat-fly/chatfly-backend-application/versions/cbb37496f138/schema)