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

# Tenant settings (optional)

> Fetched when settingsEndpoint is set. Send Authorization: ApiKey <key> (or Bearer <key>); x-api-key is also accepted.

Fetched when `settingsEndpoint` is set. Send `Authorization: ApiKey &lt;key>` (or `Bearer &lt;key>`); `x-api-key` is also accepted.

### Response

`Settings`

<ResponseField name="settings" type="object">
  <Expandable title="settings">
    <ResponseField name="companyName" type="string" />

    <ResponseField name="messageEndpoint" type="string" />

    <ResponseField name="theme" type="object">
      <Expandable title="theme">
        <ResponseField name="primary" type="string" />

        <ResponseField name="secondary" type="string" />

        <ResponseField name="text" type="string" />

        <ResponseField name="accent" type="string" />

        <ResponseField name="hover" type="string" />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="updated_at" type="string (date-time)" />

### Status codes

| Code  | Meaning |
| ----- | ------- |
| `200` | OK      |
| `400` | Error   |
| `401` | Error   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.example.com/chat-widget/settings' \
    --header 'x-widget-token: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "settings": {
      "companyName": "Acme Outdoors",
      "messageEndpoint": "string",
      "theme": {
        "primary": "string",
        "secondary": "string",
        "text": "Two-person tent, green — replacement for damaged pole set.",
        "accent": "string",
        "hover": "string"
      }
    },
    "updated_at": "2026-08-31T14:22:05Z"
  }
  ```
</ResponseExample>