---
title: "Get Public Widget Config"
method: GET
path: "/api/livechat/public/{widget_key}/config"
tags: ["livechat", "livechat"]
---

# Get Public Widget Config

`GET /api/livechat/public/{widget_key}/config`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/livechat/public/{widget_key}/config`
- Auth: none declared

Get public widget configuration.

Returns widget theme and settings for the embedded widget.
No authentication required.

## Path parameters

- `widget_key` string, required

## Response `200`

Successful Response

- PublicWidgetConfigResponse: Public widget configuration for embedding.
  - `id` integer, required
  - `name` string, required
  - `theme` object, required
  - `require_identification` boolean, required
  - `identification_fields` string[], required
  - `identification_field_config` object, nullable
  - `show_visitor_history` boolean, required
  - `proactive_greeting` PublicProactiveGreetingConfig: Public-facing proactive greeting config (subset of full config).
    - `enabled` boolean
    - `delay_seconds` integer
    - `behavior` string
  - `attachment_config` PublicAttachmentConfig: Public-facing attachment config for the widget.
    - `allow_attachments` boolean
    - `max_attachment_size_mb` integer
    - `allowed_attachment_types` string[]
  - `sound_enabled` boolean
  - `allow_voice` boolean
  - `allow_text_during_call` boolean
  - `has_voice_agent` boolean
  - `max_voice_duration_seconds` integer
  - `voice_stt_model` string
  - `voice_greeting` string
  - `voice_tts_provider` string
  - `voice_tts_voice` string
  - `allow_avatar` boolean
  - `show_branding` boolean
  - `display_mode` string
  - `localization` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/d84e7dc9977d?raw)