Theme Settings
Themes
Theme Settings
Manage theme global settings
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
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 underdata.
Common Settings
Theme settings are defined by the theme’ssettings_schema.json. Common settings include:
| Setting Key | Type | Description |
|---|---|---|
colors_accent_1 | color | Primary accent color |
colors_accent_2 | color | Secondary accent color |
colors_text | color | Body text color |
colors_background_1 | color | Primary background |
colors_background_2 | color | Secondary background |
type_header_font | font_picker | Header font family |
type_body_font | font_picker | Body font family |
type_header_font_size_scale | range | Header font size scale (%) |
type_body_font_size_scale | range | Body font size scale (%) |
logo | image_picker | Store logo |
favicon | image_picker | Browser favicon |
Errors
Errors return a numeric HTTP status with an envelope of the form{ "status": <code>, "state": "error", "message": "<reason>", "data": null }.
| HTTP Status | When |
|---|---|
401 | Invalid or missing access token |
403 | App doesn’t have the required scope (read_themes for GET, write_themes for PUT) |
404 | Store not found |
400 | The settings could not be saved (the underlying error message is returned in message) |
500 | Unexpected server error |