Skip to main content
PUT
/
organization
/
chat
Update chat widget configuration
curl --request PUT \
  --url https://api.getfernand.com/organization/chat \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "channel": 12345
}
'
{
  "secret": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "settings": {
    "channel": 12345,
    "domains": [
      "piedpiper.com",
      "piedpiper.dev",
      "piedpiper.xyz"
    ]
  }
}
Updates the organization’s chat widget settings. The channel property must be a valid channel ID belonging to the organization.

Authorizations

X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Body

application/json
channel
integer
required

Default channel ID for chat conversations (required).

Example:

12345

domains
string

Comma-separated list of allowed domains for chat widget (optional).

Example:

"piedpiper.com,piedpiper.dev,piedpiper.xyz"

Response

Chat configuration updated successfully.

secret
string

Secure key for HMAC authentication of chat widget.

Example:

"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"

settings
object

Chat widget settings.