Set the brand design system; the platform writes the tokens into css/base.css
Send only what you want to change; everything you leave out keeps its current value, and invalid values are ignored without touching any other setting; the ignored keys are listed in the response as ignored. Contrast problems are reported. The managed token block sits between the design-system markers at the top of css/base.css, and any later stylesheet that redefines a changed token in its :root (for example css/theme.css on a starter site) is updated too, so the change shows on every page.
https://app.softsolz.uk/api/v1/services/site-builder/projects/{id}/design-systemRecent Requests
Kept only in this browserPath Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
stylestringOne of the names from GET /projects/{id}/design-system styles.
colorsobjectHex colors: primary, secondary, accent, bg, surface, text, muted, border.
typographyobject{ heading, body, heading_weight, body_weight } Google Fonts family names.
radius_pxintegerCorner radius in pixels (0 to 48); small and large corners follow it.
shadow_presetstringShadow strength: none, soft or sharp.
densitystringSpacing: compact, balanced or roomy.
brandobject{ name, voice, logo_path }.
Response
Response Body
design_systemobjectThe saved design system.changedarray of stringsStylesheet paths rewritten.Request
curl --request PUT \ --url https://app.softsolz.uk/api/v1/services/site-builder/projects/{id}/design-system \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "style": "premium", "colors": { "primary": "#b45309", "bg": "#fffaf5", "text": "#1f1a17" }, "typography": { "heading": "Fraunces", "body": "Inter" }, "radius_px": 12, "shadow_preset": "soft", "density": "balanced", "brand": { "name": "Northwind Bakery", "voice": "warm, confident" }}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": { "design_system": { "style": "premium", "colors": { "primary": "#b45309" }, "typography": { "heading": "Fraunces", "body": "Inter" }, "radius": { "md": "10px" }, "radius_px": 10, "shadow": { "md": "0 4px 12px rgba(16, 24, 40, 0.08)" }, "shadow_preset": "soft", "spacing": { "md": "16px" }, "density": "balanced", "used_colors": [ "primary", "bg", "text" ], "direction": { "gradients": false }, "structure": {}, "brand": { "name": "Northwind Bakery" }, "contrast_warnings": [] }, "changed": [ "css/base.css" ] }}