---
title: "Update a Widget integration"
method: POST
path: "/integration/widget/{widgetIntegrationId}/update"
tags: ["Widget Integration"]
---

# Update a Widget integration

`POST /integration/widget/{widgetIntegrationId}/update`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/widget/{widgetIntegrationId}/update`
- Auth: HTTP bearer

## Path parameters

- `widgetIntegrationId` string, required: The ID of the Widget integration

## Request body

- object: A bot configuration that can be applied without a dedicated bot instance.
  - `alias` string, nullable: The unique alias for the instance
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `blueprintId` string, nullable: The ID of the blueprint
  - `botId` string, nullable: The ID of the bot this configuration is using
  - `theme` string: The theme of the Widget integration
  - `layout` string: The default layout of the Widget integration
  - `title` string: The title of the Widget integration
  - `intro` string: The intro of the Widget integration
  - `initial` string: The initial message of the Widget integration
  - `placeholder` string: The input placeholder of the Widget integration
  - `origin` string: The origin URLs of the Widget integration
  - `sessionDuration` number: The session duration of the Widget integration
  - `language` string: The language of the Widget integration
  - `plugins` string: The plugins of the Widget integration
  - `stream` boolean: Whether the Widget integration is streaming
  - `verbose` boolean: Whether the Widget integration is verbose
  - `tools` boolean: Whether the Widget integration has tools
  - `unfurl` boolean: Whether the Widget integration unfurls links
  - `math` boolean: Whether the Widget integration supports math
  - `carousel` boolean: Whether the Widget integration supports carousels
  - `form` boolean: Whether the Widget integration supports forms
  - `attachments` boolean: Whether the Widget integration supports attachments
  - `autoScroll` boolean: Whether the Widget integration auto scrolls
  - `startFirst` boolean: Whether the Widget integration starts first
  - `contactCollection` boolean: Whether the Widget integration collects contacts
  - `exportConversation` boolean: Controls whether the Widget allows exporting the current conversation
  - `restartConversation` boolean: Controls whether the Widget allows restarting the conversation
  - `maximize` boolean: Controls whether the Widget allows maximizing the conversation
  - `messagePeek` boolean: Controls whether the Widget allows peeking at the initial messages
  - `voiceIn` boolean: Controls whether the Widget allows voice input
  - `voiceOut` boolean: Controls whether the Widget allows voice output
  - `poweredBy` boolean: Whether the Widget integration displays powered by

## Response `200`

The Widget integration was updated successfully

- object
  - `id` string, required: The ID of the Widget Integration

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)