---
title: "Update Chatbot Appearance"
method: PATCH
path: "/v0/chatbots/{chatbotId}/appearance"
tags: ["Chatbot Appearance"]
---

# Update Chatbot Appearance

`PATCH /v0/chatbots/{chatbotId}/appearance`

## Request

- Base URL: `https://sitegpt.ai/api`
- URL: `https://sitegpt.ai/api/v0/chatbots/{chatbotId}/appearance`
- Auth: HTTP bearer

Update appearance of the chatbot

## Path parameters

- `chatbotId` string, required

## Request body

- object: Request Body
  - `title` string: Title of the chatbot
  - `welcomeMessage` string: The first message that the users will see in the chatbot
  - `placeholderText` string: Placeholder text that users see before they type their question in the chat
  - `brandColor` string: Primary color of the chatbot
  - `brandTextColor` string: Primary text color of the chatbot
  - `fontSize` integer: Font size of the text shown in chatbot (in px)
  - `height` number: Height of the chatbot
  - `learnMore` string: Learn More localization setting of the chatbot
  - `ctaText` string: Call to Action text
  - `ctaLink` string: Call to Action link
  - `watermarkText` string: Text to be shown as the watermark in the chatbot
  - `watermarkLink` string: Url of the watermark to be shown in the chatbot
  - `autoOpenChatWindowInDesktop` 'ALWAYS_OPEN_WITH_DELAY' | 'DONT_OPEN': Option to handle behaviour auto open chat window in desktop
  - `autoOpenChatWindowDelayInDesktop` integer: Delay after which the chat window will shown in desktop when autoOpenChatWindowInDesktop is set to AUTO_OPEN_WITH_DELAY
  - `autoOpenChatWindowInMobile` 'ALWAYS_OPEN_WITH_DELAY' | 'DONT_OPEN': Option to handle behaviour auto open chat window in mobile
  - `autoOpenChatWindowDelayInMobile` integer: Delay after which the chat window will shown in mobile when autoOpenChatWindowInMobile is set to AUTO_OPEN_WITH_DELAY
  - `hideWatermark` boolean: Indicates whether the watermark is shown in the chatbot or not
  - `hideSources` boolean: Indicates whether to display sources or not in the chatbot
  - `hideTooltip` boolean: Indicates whether to hide tooltip or not in the chatbot
  - `hideFeedbackButtons` boolean: Indicates whether to hide feedback buttons (for each reply) or not in the chatbot
  - `rtl` boolean: Indicates whether to display the text in the chatbot right to left or opposite
  - `distanceFromBottom` integer: Distance from bottom (in px) where the chatbot icon should be shown
  - `horizontalDistance` integer: Horizantal distance (in px) where the chatbot icon should be shown
  - `iconSize` 'SMALL' | 'MEDIUM' | 'LARGE' | 'XL' | '2XL' | '3XL' | '4XL' | '5XL': Possible options foe icon size of the chatbot
  - `iconPosition` 'LEFT' | 'RIGHT': Possible options for icon position of the chatbot

## Response `200`

OK

- object: Success Response
  - `success` boolean: Indicates whether this is success response or error response
  - `message` string: Overall message regarding the operation performed
  - `data` object, nullable: Data returned from the server

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `405`: Method Not Allowed
- `500`: Internal Server Error

---

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