Docs
Workspace

Update the design system

PATCH/workspaces/current/brand-themeNeedsworkspace.settings

Partial: 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

secretKey
headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Request Body

application/json
  1. body
style?string
Value in"clean""soft"
font?string
Value in"system""humanist""serif""rounded"
radius?integer
Range0 <= value <= 32
buttonRadius?integer
Range0 <= value <= 24
shadow?string
Value in"none""small""medium""large""custom"
customShadow?
showBorder?boolean
sizes?
secondaryButton?string
Value in"text""outline"
buttonSize?string
Value in"medium""large"
bannerEmphasized?boolean
light?
dark?

Response Body

OK

application/json
  1. 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": {}
}