---
title: "Update Chatbot"
method: PUT
path: "/chatbots/{chatbot_id}"
tags: ["Chatbots"]
---

# Update Chatbot

`PUT /chatbots/{chatbot_id}`

## Request

- Base URL: `https://app.boei.help/api/v1`
- URL: `https://app.boei.help/api/v1/chatbots/{chatbot_id}`
- Auth: HTTP bearer

Change a chatbot's settings. Only the fields you send are changed; everything else keeps its current value. Returns the chatbot with its current settings.

NOTE: Read the current values with chatbots.get first. specific_instructions and quick_buttons replace the whole list, so send the full list back with your change. custom_instructions is free-form guidance for the AI; specific_instructions are short rules (mark is_critical=true for rules the bot must never break); tone_of_voice is a free-text description of the voice that refines ai_tone. Visual styling, the AI model, live-chat routing and integrations cannot be changed here.

## Request body

- object
  - `name` string: Chatbot display name.
  - `business_name` string: Your business name as the bot introduces it.
  - `business_description` string: What the business does, used to ground answers.
  - `opening_text` string: First message the visitor sees.
  - `placeholder_text` string: Placeholder in the chat input.
  - `button_text` string: Label on the chat button.
  - `custom_instructions` string: Free-form instructions for the AI.
  - `specific_instructions` object[]: Short rules the bot follows. Max 20. Replaces the whole list.
    - `text` string, required: The rule.
    - `is_critical` boolean: Mark as a rule the bot must never break.
  - `quick_buttons` object[]: Quick prompts shown as buttons in the chat. Max 10. Replaces the whole list; send [] to remove all.
    - `text` string, required: Button label, max 50 characters.
  - `quick_prompts_display` string: When to show the quick prompts: always, once (only at the start of a conversation) or never.
  - `ai_tone` string: One of: appreciative, assertive, authoritative, conciliatory, curious, empathetic, energetic, friendly, humorous, informative, inspirational, objective, persuasive, professional, supportive, thoughtful, urgent.
  - `tone_of_voice` string: Extra description of the voice (max 400 chars).
  - `ai_response_length` string: One of: short, medium, long.
  - `ai_follow_up_questions` boolean: Suggest follow-up questions after answers.
  - `focus` string: informational or conversion.
  - `primary_goal` string: What the bot should steer visitors towards.
  - `language` string: Default language code.
  - `respond_in_user_language` boolean: Answer in the visitor's language.
  - `web_search_enabled` boolean: Allow the bot to search the web when training data has no answer.
  - `show_sources` boolean: Show source links under answers.
  - `allowed_sensitive_topics` string[]: Topics the bot may discuss: politics, religion, legal_advice, medical_advice, competitor_comparison.
  - `custom_blocked_topics` string[]: Topics the bot must refuse (max 20).

## Response `200`

- object
  - `chatbot_id` string
  - `name` string
  - `status` string
  - `training_sources` integer
  - `created_at` string
  - `settings` object
    - `business_name` string
    - `opening_text` string
    - `ai_tone` string
    - `specific_instructions` object[]
      - `text` string
      - `is_critical` boolean

## Other responses

- `404`: Not found

---

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