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.
The request body is the flat settings map itself — the setting keys go at the top level of the body. Do not wrap them in a "settings" key: the endpoint forwards the entire body as the settings object, so a { "settings": { ... } } body arrives double-wrapped (settings.settings.*) and nothing is applied.

Request

Body Parameters

The body is a flat object of setting key: value pairs to update (sent at the top level, not nested under a settings key).

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:

Errors

Errors return a numeric HTTP status with an envelope of the form { "status": <code>, "state": "error", "message": "<reason>", "data": null }.