---
title: "Update chatbot settings"
method: POST
path: "/update-chatbot-settings"
tags: ["Chatbots"]
---

# Update chatbot settings

`POST /update-chatbot-settings`

Updates various chatbot configuration settings

## Request body

- object
  - `chatbotId` string, required — ID of the chatbot to update
  - `name` string — Chatbot name
  - `instructions` string — System instructions for the chatbot
  - `initialMessages` string[] — Initial greeting messages
  - `suggestedMessages` string[] — Suggested conversation starters
  - `visibility` 'public' | 'private' — Enable or disable access to the chatbot
  - `domains` string[] — Allowed domains for the chatbot
  - `onlyAllowOnAddedDomains` boolean — Whether to restrict to allowed domains only
  - `ipLimit` integer — Rate limit per IP address
  - `ipLimitTimeframe` integer — Timeframe for IP rate limiting
  - `ipLimitMessage` string — Message shown when rate limit is exceeded
  - `model` 'gpt-4o-mini' | 'gpt-oss-120b' | 'gpt-oss-20b' | 'gpt-5.2' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-opus-4-5' | 'claude-haiku-4-5' | 'claude-sonnet-4-5' | 'gemini-2.5-pro' | 'gemini-3-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.1-pro' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'grok-3' | 'grok-3-mini' | 'grok-4' | 'DeepSeek-V3' | 'DeepSeek-R1' | 'DeepSeek-V4-Flash' | 'Llama-4-Scout-17B-16E-Instruct' | 'Llama-4-Maverick-17B-128E-Instruct-FP8' | 'kimi-k2' | 'mistral-medium-3.5' | 'mistral-small-2603' | 'glm-5.2' | 'auto' — AI model to use for the response
  - `temp` number — Temperature setting for AI responses
  - `styles` ChatbotStyles
    - `theme` 'light' | 'dark' — UI theme
    - `buttonColor` string — Color for buttons (hex code)
    - `displayName` string — Display name for the chatbot
    - `alignChatButton` 'left' | 'right' — Chat button alignment
    - `userMessageColor` string — Color for user messages (hex code)
    - `autoOpenChatWindowAfter` integer — Auto-open delay in seconds (0 to disable)
  - `collectCustomerInformation` CollectLeadsSettings
    - `title` string — Form title
    - `name` object
      - `active` boolean — Whether name field is enabled
      - `label` string — Label for name field
    - `email` object
      - `active` boolean — Whether email field is enabled
      - `label` string — Label for email field
    - `phone` object
      - `active` boolean — Whether phone field is enabled
      - `label` string — Label for phone field

## Response `202`

Settings updated successfully

- object
  - `message` string

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Access denied or quota exceeded
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error

---

[API](https://skmtc.dev/chatbase/apis/chatbase-api-v1.md) · [All operations](https://skmtc.dev/chatbase/apis/chatbase-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chatbase/chatbase-api-v1/revisions/3a2187967746/schema)