Agents

Update widget configuration

View as Markdown

Updates the web widget configuration for the agent. Only provided fields are updated (partial update). When avatarUrl is changed, the old CDN avatar is automatically deleted from S3. The avatarUrl must be a URL from the platform’s CDN domain — use POST /agent/{id}/avatar/presigned-url to upload first.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired
Agent ObjectId

Request

This endpoint expects an object.
widgetConfigobjectOptional

All fields are optional — only provided fields are updated

Response

Updated widget configuration
successboolean
dataobject
The updated widgetConfig object

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error