Chat widget
Update chat widget
PATCH
Change the chat widget of an agent: colours, position, texts, languages, suggested questions and FAQ. Owner/admin.
bearer agents:writeheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: agents:write
agentId*stringAI agent id. Never invent ids – list resources first.
Length
1 <= length <= 64application/json- body
primaryColor?stringMatch
^#[0-9a-fA-F]{6}$position?stringValue in
"bottom-left""bottom-right"themeMode?stringValue in
"light""dark""auto"requireEmailBeforeChat?booleanheaderTitle?stringLength
length <= 100headerStatus?stringLength
length <= 100inputPlaceholder?stringLength
length <= 100welcomeMessage?stringLength
length <= 2000autoDetectLocale?booleandefaultLocale?stringLength
length <= 10supportedLocales?array<>Items
1 <= items <= 30suggestions?array<>Suggested first questions shown in the widget.
Items
items <= 5faq?array<>Answers shown for the suggested questions, same order.
Items
items <= 5translations?Per-language overrides keyed by locale.
Success
application/json- response
agentId*stringchanged*array<string>curl -X PATCH "https://example.com/agents/string/widget" \ -H "Content-Type: application/json" \ -d '{}'{ "agentId": "string", "changed": [ "string" ]}