---
title: "Update chat widget configuration"
method: POST
path: "/workspace/{workspaceId}/chat"
tags: ["Workspace"]
---

# Update chat widget configuration

`POST /workspace/{workspaceId}/chat`

## Request

- Base URL: `https://api.savanto.ai`
- URL: `https://api.savanto.ai/workspace/{workspaceId}/chat`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, required

## Request body

- object
  - `enabled` boolean
  - `triggerPosition` 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
  - `triggerIconUrl` union
    - string, uri
    - ''
  - `triggerShowBackground` boolean
  - `triggerShowBorder` boolean
  - `title` string
  - `subtitle` string
  - `avatarUrl` union
    - string, uri
    - ''
  - `headerAvatarShowBackground` boolean
  - `headerAvatarShowBorder` boolean
  - `greeting` string
  - `greetingSubtext` string
  - `greetingIconUrl` union
    - string, uri
    - ''
  - `placeholder` string
  - `cardLayout` 'carousel' | 'stack'
  - `promptStyle` 'inline' | 'input' | 'both'
  - `productCardVariant` 'default' | 'horizontal'
  - `productCardImageDisplay` 'contain' | 'cover' | 'backdrop'
  - `productCardImageAspectRatio` 'square' | 'landscape' | 'wide'
  - `postCardImageDisplay` 'contain' | 'cover' | 'backdrop'
  - `postCardImageAspectRatio` 'square' | 'landscape' | 'wide'
  - `showMessageActions` boolean
  - `showUserCopyButton` boolean
  - `showMessageTimestamps` boolean
  - `showPostImage` boolean
  - `showPostAuthor` boolean
  - `showPostDate` boolean
  - `showPostCategory` boolean
  - `popoverEnabled` boolean
  - `popoverMessage` string
  - `popoverDelay` integer
  - `popoverShowOnce` boolean
  - `theme` object
    - `colorScheme` 'light' | 'dark' | 'auto'
    - `colors` object
      - `primaryColor` string
      - `primaryHover` string
      - `linkColor` string
      - `widgetBackground` string
      - `backgroundSecondary` string
      - `assistantBubbleBackground` string
      - `borderColor` string
      - `focusBorderColor` string
    - `header` object
      - `background` string
      - `titleColor` string
      - `subtitleColor` string
      - `iconColor` string
    - `triggerButton` object
      - `background` string
      - `hoverBackground` string
      - `borderColor` string
    - `referenceCard` object
      - `background` string
      - `borderColor` string
      - `hoverBackground` string
      - `borderRadius` number
      - `titleColor` string
      - `metaColor` string
      - `descriptionColor` string
    - `promptChip` object
      - `background` string
      - `textColor` string
      - `borderColor` string
      - `hoverBackground` string
      - `hoverBorderColor` string
    - `typography` object
      - `fontFamily` string
      - `fontSize` 'small' | 'medium' | 'large'
    - `borderRadius` number
    - `maxWidth` number
    - `maxHeight` number
  - `darkTheme` object
    - `colorScheme` 'light' | 'dark' | 'auto'
    - `colors` object
      - `primaryColor` string
      - `primaryHover` string
      - `linkColor` string
      - `widgetBackground` string
      - `backgroundSecondary` string
      - `assistantBubbleBackground` string
      - `borderColor` string
      - `focusBorderColor` string
    - `header` object
      - `background` string
      - `titleColor` string
      - `subtitleColor` string
      - `iconColor` string
    - `triggerButton` object
      - `background` string
      - `hoverBackground` string
      - `borderColor` string
    - `referenceCard` object
      - `background` string
      - `borderColor` string
      - `hoverBackground` string
      - `borderRadius` number
      - `titleColor` string
      - `metaColor` string
      - `descriptionColor` string
    - `promptChip` object
      - `background` string
      - `textColor` string
      - `borderColor` string
      - `hoverBackground` string
      - `hoverBorderColor` string
    - `typography` object
      - `fontFamily` string
      - `fontSize` 'small' | 'medium' | 'large'
    - `borderRadius` number
    - `maxWidth` number
    - `maxHeight` number
  - `customCSS` string
  - `resetToDefaults` boolean

## Response `201`

Updated chat config

- object
  - `object` 'widget_config', required
  - `requestId` string, required
  - `data` object, required
    - `config` object, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `413`: Payload too large
- `429`: Rate limit exceeded

---

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