Skip to main content
PATCH
Update Widget

Authentication

Requires a Bearer token (API key) or a dashboard session.

Path Parameters

string
required
The widget config UUID.

Request

All fields are optional — include only what you want to change.
string
Display name for the widget.
string
"active" or "disabled".
string
Re-link the widget to a different API key.
object
Visual customization (primaryColor, position, borderRadius, fontFamily, …).
object
Behavioral settings (welcomeMessage, placeholder, maxPromptLength, enableFileUpload, enableVoice, strictAbuse).
object
Security settings: the bot-protection toggle and the domain allowlist (allowedOrigins/allowedDomains).
object
Human-escalation intent config (custom keyword triggers and actions).

Response

object
The updated widget config.

Example

curl