v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Agent Builder

Update agent theme

Updates textual and color theme settings. Requires a USER API key.

put/public/v1/agents/{agentId}/theme

Path parameters

agentIdstring required
Example:uuid-xxxx-xxxx

Request body

avatarstring nullable required
bubbleImagestring nullable required
titlestring required
initialMessagestring required
placeholderstring required
bubbleColorstring required
userMessageColorstring required
agentMessageColorstring nullable required
bubbleAlignment'RIGHT' | 'LEFT' required
progressIndicator'STATIC' | 'DYNAMIC' required
verticalPositionInPixelsnumber required

Example request

{
  "avatar": "example",
  "bubbleImage": "example",
  "title": "example",
  "initialMessage": "example",
  "placeholder": "example",
  "bubbleColor": "example",
  "userMessageColor": "example",
  "agentMessageColor": "example",
  "bubbleAlignment": "RIGHT",
  "progressIndicator": "STATIC",
  "verticalPositionInPixels": 1
}

Response

Updated agent theme

idnumber required
assistantIdstring required
avatarstring nullable required
bubbleImagestring nullable required
titlestring required
initialMessagestring required
placeholderstring required
bubbleColorstring required
userMessageColorstring required
agentMessageColorstring nullable required
bubbleAlignment'RIGHT' | 'LEFT' required
progressIndicator'STATIC' | 'DYNAMIC' required
verticalPositionInPixelsnumber required
updatedAtstring required

Example response

{
  "id": 1,
  "assistantId": "example",
  "avatar": "example",
  "bubbleImage": "example",
  "title": "example",
  "initialMessage": "example",
  "placeholder": "example",
  "bubbleColor": "example",
  "userMessageColor": "example",
  "agentMessageColor": "example",
  "bubbleAlignment": "RIGHT",
  "progressIndicator": "STATIC",
  "verticalPositionInPixels": 1,
  "updatedAt": "example"
}