Skip to main content

Update Widget Style

Updates a widget style. Only id is required; pass any subset of the other fields. Changes are reflected immediately for any iframe that fetches this style on next load.

Authentication: Bearer token required.

Endpoint: PUT /api/v2/widget-styles


Request Body

FieldTypeRequiredDescription
idstringYesWidget style UUID
namestringNomin 1, max 255
primary_colorstringNomax 32
secondary_colorstringNomax 32
background_colorstringNomax 32
surface_colorstringNomax 32
text_colorstringNomax 32
muted_text_colorstringNomax 32
border_colorstringNomax 32
font_familystringNomax 255
font_size_baseintNomin 8, max 32
font_size_headingintNomin 10, max 64
font_weight_headingintNomin 100, max 900
border_radiusintNomin 0, max 64
custom_cssstringNomax 32768

Response — 200 OK

Returns the updated WidgetStyleResponse.

StatusDescription
400Validation error
401Unauthorized
403No access to style's node
404Widget style not found