SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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.

PUThttps://app.softsolz.uk/api/v1/services/site-builder/projects/{id}/design-system

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

stylestring

One of the names from GET /projects/{id}/design-system styles.

colorsobject

Hex colors: primary, secondary, accent, bg, surface, text, muted, border.

typographyobject

{ heading, body, heading_weight, body_weight } Google Fonts family names.

radius_pxinteger

Corner radius in pixels (0 to 48); small and large corners follow it.

shadow_presetstring

Shadow strength: none, soft or sharp.

densitystring

Spacing: 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"
]
}
}