> ## Documentation Index
> Fetch the complete documentation index at: https://developers.getfernand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update chat widget configuration

Updates the organization's chat widget settings. The channel property must be a valid channel ID belonging to the organization.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json put /organization/chat
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /organization/chat:
    put:
      tags:
        - Chat Widget
      summary: Update chat widget configuration
      description: >-
        Updates the organization's chat widget settings. The channel property
        must be a valid channel ID belonging to the organization.
      operationId: updateChatConfiguration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channel:
                  type: integer
                  description: Default channel ID for chat conversations (required).
                  example: 12345
                domains:
                  type: string
                  description: >-
                    Comma-separated list of allowed domains for chat widget
                    (optional).
                  example: piedpiper.com,piedpiper.dev,piedpiper.xyz
              required:
                - channel
      responses:
        '200':
          description: Chat configuration updated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  secret:
                    type: string
                    description: Secure key for HMAC authentication of chat widget.
                    example: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0
                  settings:
                    type: object
                    description: Chat widget settings.
                    properties:
                      channel:
                        type: integer
                        description: Default channel ID for chat conversations.
                        example: 12345
                      domains:
                        type: array
                        description: List of allowed domains for chat widget.
                        items:
                          type: string
                        example:
                          - piedpiper.com
                          - piedpiper.dev
                          - piedpiper.xyz
        '400':
          description: Invalid channel or domain provided.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````