Upload a custom chat-button (launcher) icon (admin)

POST 
/api/widget/settings/chat-button-icon

A PNG/JPG/WebP image (48–3000 px, ≤ 4 MB) used as the launcher icon, overriding the built-in set. Admin only.

Request

Responses

200

The updated widget settings (with the new chat_button_icon_url).

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

403

Authenticated but not allowed.

422

The request failed validation.