Workspace
Update the design system
PATCH
/workspaces/current/brand-themeNeedsworkspace.settingsPartial: light/dark colours, customShadow and sizes merge. A new style resets to that style's defaults first. Themed items on your site change within a minute, without re-publishing.
Authorization
secretKeyheader
AuthorizationBearer <sk_…>A secret API key from Settings → API keys. It acts with its creator's role.
Request Body
application/json- body
style?stringValue in
"clean""soft"font?stringValue in
"system""humanist""serif""rounded"radius?integerRange
0 <= value <= 32buttonRadius?integerRange
0 <= value <= 24shadow?stringValue in
"none""small""medium""large""custom"customShadow?showBorder?booleansizes?secondaryButton?stringValue in
"text""outline"buttonSize?stringValue in
"medium""large"bannerEmphasized?booleanlight?dark?Response Body
OK
application/json- response
brandTheme*styles*Each style's full defaults (clean, soft).
Shell
curl -X PATCH 'https://app.cueston.com/api/workspaces/current/brand-theme' \
-H 'Content-Type: application/json' \
-d '{}'Example Response
JSON
{
"brandTheme": {
"style": "clean",
"font": "system",
"radius": 0,
"buttonRadius": 0,
"buttonSize": "medium",
"shadow": "none",
"customShadow": {
"x": 0,
"y": 0,
"blur": 0,
"spread": 0,
"color": "string",
"opacity": 0
},
"showBorder": true,
"secondaryButton": "text",
"bannerEmphasized": true,
"light": {
"surfaceColor": "string",
"textColor": "string",
"accentColor": "string",
"accentTextColor": "string",
"borderColor": "string"
},
"dark": {
"surfaceColor": "string",
"textColor": "string",
"accentColor": "string",
"accentTextColor": "string",
"borderColor": "string"
},
"sizes": {}
},
"styles": {}
}Get the design systemGET
The workspace's design system (brand theme) for guidance on your site: style, font, light and dark colours, corners, shadow, buttons and default widths. Items with useBrandTheme follow it.
Get interruption limitsGET
How many modal-style items (tours, backdrop banners, surveys, auto-opened checklists) a visitor gets per session and day.