Skip to main content
GET
Theme Settings

Theme Settings

Manage global theme settings (colors, typography, layout options, etc.).

Get Theme Settings

Retrieve the current theme settings.

Request

Response

The response uses the standard envelope (status, state, message, data). data.settings holds the current setting values, data.schema holds the theme’s settings schema groups, and data.presets lists the available preset names (data.currentPreset is the active preset name, or null when settings are stored as a direct object).

Update Theme Settings

Update one or more theme settings.

Request

Body Parameters

settings
object
required
Object containing setting key-value pairs to update

Response

The submitted settings are merged into the active preset (or the current settings object) and saved. The response uses the standard envelope; the proxied save result is returned verbatim under data.

Common Settings

Theme settings are defined by the theme’s settings_schema.json. Common settings include:
Setting KeyTypeDescription
colors_accent_1colorPrimary accent color
colors_accent_2colorSecondary accent color
colors_textcolorBody text color
colors_background_1colorPrimary background
colors_background_2colorSecondary background
type_header_fontfont_pickerHeader font family
type_body_fontfont_pickerBody font family
type_header_font_size_scalerangeHeader font size scale (%)
type_body_font_size_scalerangeBody font size scale (%)
logoimage_pickerStore logo
faviconimage_pickerBrowser favicon

Errors

Errors return a numeric HTTP status with an envelope of the form { "status": <code>, "state": "error", "message": "<reason>", "data": null }.
HTTP StatusWhen
401Invalid or missing access token
403App doesn’t have the required scope (read_themes for GET, write_themes for PUT)
404Store not found
400The settings could not be saved (the underlying error message is returned in message)
500Unexpected server error