> ## Documentation Index > Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update the widget configuration of a website channel ## OpenAPI ````yaml /api-referansi/openapi.json put /v1/channels/{id}/widget openapi: 3.1.0 info: title: Flextell API version: 0.0.1 description: >- Flextell REST API referansı. Kimlik doğrulama, scope ve istek kuralları için API sekmesindeki rehberlere bakın. servers: - url: https://app.flextell.ai/api description: Üretim security: - oauth2: [] - bearer: [] paths: /v1/channels/{id}/widget: put: tags: - ChannelWidget summary: Update the widget configuration of a website channel operationId: channelWidget.update parameters: - name: id in: path required: true description: The channel identifier schema: type: integer - name: X-Tenant in: header required: true description: >- Tenant identifier. Send the Tenant ID in the `X-Tenant` header to scope API requests to a specific tenant. schema: type: number requestBody: content: application/json: schema: $ref: '#/components/schemas/ChannelWidgetUpdateRequest' responses: '200': description: '' content: application/json: schema: type: object '401': $ref: '#/components/responses/AuthenticationException' '403': $ref: '#/components/responses/AuthorizationException' '422': $ref: '#/components/responses/ValidationException' components: schemas: ChannelWidgetUpdateRequest: type: object description: >- Mirrors the field set of the Filament "Widget Ayarları" page. Every key is optional so a client can patch a single colour without resending the whole theme; omitted keys keep their stored value. properties: primary_color: type: - string - 'null' description: The main brand colour of the widget. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ secondary_color: type: - string - 'null' description: The secondary colour used in the header gradient. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ background_color: type: - string - 'null' description: The background colour of the widget panel. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ border_radius: type: integer description: The corner radius of the widget panel in pixels. minimum: 0 maximum: 50 shadow: type: string description: The drop shadow of the widget panel (none, small, medium, large). enum: - none - small - medium - large title: type: string description: The title shown in the widget header. maxLength: 100 header_bg_color: type: - string - 'null' description: The background colour of the header. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ header_text_color: type: - string - 'null' description: The text colour of the header. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ header_padding: type: integer description: The inner spacing of the header in pixels. minimum: 4 maximum: 40 show_header_gradient: type: boolean description: Whether the header is filled with a gradient. welcome_message: type: string description: The greeting shown before the visitor writes anything. maxLength: 500 auto_open_delay: type: - integer - 'null' description: >- Seconds before the widget opens itself. Send null to disable auto-open. minimum: 1 maximum: 60 allow_message_editing: type: boolean description: Whether authorized staff can edit outbound website text messages. allow_message_deletion: type: boolean description: >- Whether authorized staff can delete outbound website messages and attachments. font_family: type: string description: The font family slug used by the widget. enum: - system - inter - roboto - open-sans - nunito - lato - poppins - montserrat - raleway - dm-sans - plus-jakarta-sans - manrope - outfit - work-sans - source-sans-3 - rubik - figtree - ubuntu - playfair-display - merriweather - lora - pt-serif - noto-serif - libre-baskerville - fira-code - jetbrains-mono - source-code-pro - bebas-neue - righteous - space-grotesk base_font_size: type: integer description: The base font size in pixels. minimum: 8 maximum: 72 header_font_size: type: integer description: The header font size in pixels. minimum: 8 maximum: 72 message_font_size: type: integer description: The message font size in pixels. minimum: 8 maximum: 72 header_font_weight: type: integer description: The header font weight. minimum: 100 maximum: 900 message_font_weight: type: integer description: The message font weight. minimum: 100 maximum: 900 send_button_font_weight: type: integer description: The send button font weight. minimum: 100 maximum: 900 user_msg_bg_color: type: - string - 'null' description: The background colour of the visitor's own messages. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ user_msg_text_color: type: - string - 'null' description: The text colour of the visitor's own messages. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ agent_msg_bg_color: type: - string - 'null' description: The background colour of the assistant's messages. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ agent_msg_text_color: type: - string - 'null' description: The text colour of the assistant's messages. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ message_border_radius: type: integer description: The corner radius of message bubbles in pixels. minimum: 0 maximum: 40 message_padding: type: integer description: The inner spacing of message bubbles in pixels. minimum: 4 maximum: 32 message_spacing: type: integer description: The vertical gap between messages in pixels. minimum: 0 maximum: 32 input_placeholder: type: string description: The placeholder text of the message input. maxLength: 100 input_bg_color: type: - string - 'null' description: The background colour of the message input. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ input_text_color: type: - string - 'null' description: The text colour of the message input. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ input_border_color: type: - string - 'null' description: The border colour of the message input. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ input_border_radius: type: integer description: The corner radius of the message input in pixels. minimum: 0 maximum: 30 send_button_color: type: - string - 'null' description: The background colour of the send button. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ send_button_icon_color: type: - string - 'null' description: The icon colour of the send button. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ bubble_icon: type: string description: The icon shown on the floating button (chat, headset, help, wave). enum: - chat - headset - help - wave fab_size: type: integer description: The diameter of the floating button in pixels. minimum: 40 maximum: 80 fab_bg_color: type: - string - 'null' description: The background colour of the floating button. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ fab_icon_color: type: - string - 'null' description: The icon colour of the floating button. pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$ fab_border_radius: type: integer description: The corner radius of the floating button in pixels. minimum: 0 maximum: 9999 fab_shadow: type: string description: The drop shadow of the floating button (none, small, medium, large). enum: - none - small - medium - large fab_pulse_animation: type: boolean description: Whether the floating button pulses to draw attention. position: type: string description: The corner the widget sits in (bottom-right, bottom-left). enum: - bottom-right - bottom-left position_bottom: type: integer description: The gap from the bottom of the page in pixels. minimum: 0 maximum: 100 position_side: type: integer description: The gap from the side of the page in pixels. minimum: 0 maximum: 100 widget_width: type: integer description: The width of the widget panel in pixels. minimum: 280 maximum: 500 widget_height: type: integer description: The height of the widget panel in pixels. minimum: 400 maximum: 800 custom_css: type: - string - 'null' description: Extra CSS injected into the widget. maxLength: 10000 title: ChannelWidgetUpdateRequest responses: AuthenticationException: description: Unauthenticated content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message AuthorizationException: description: Authorization error content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message ValidationException: description: Validation error content: application/json: schema: type: object properties: message: type: string description: Errors overview. errors: type: object description: A detailed description of each field that failed validation. additionalProperties: type: array items: type: string required: - message - errors securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://dev.flextell.ai/oauth/authorize tokenUrl: https://dev.flextell.ai/oauth/token scopes: '*': all bearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.