Skip to main content
GET
/
api
/
v1
/
themes
/
{theme_id}
/
settings.json
Theme Settings
curl --request GET \
  --url https://api.launchmystore.io/api/v1/themes/{theme_id}/settings.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "settings": {}
}'

​
Theme Settings

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

​
Get Theme Settings

Retrieve the current theme settings.

​
Request

curl -X GET "https://api.launchmystore.io/api/v1/themes/theme_abc123/settings.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Response

{
  "success": true,
  "data": {
    "current": {
      "colors_solid_button_labels": "#ffffff",
      "colors_accent_1": "#121212",
      "colors_accent_2": "#334FB4",
      "colors_text": "#121212",
      "colors_outline_button_labels": "#121212",
      "colors_background_1": "#ffffff",
      "colors_background_2": "#f3f3f3",
      "type_header_font": "Assistant",
      "type_body_font": "Assistant",
      "type_header_font_size_scale": 100,
      "type_body_font_size_scale": 100
    },
    "presets": {
      "Default": {
        "colors_accent_1": "#121212",
        "colors_background_1": "#ffffff"
      },
      "Dark": {
        "colors_accent_1": "#ffffff",
        "colors_background_1": "#121212"
      }
    }
  }
}

​
Update Theme Settings

Update one or more theme settings.

​
Request

curl -X PUT "https://api.launchmystore.io/api/v1/themes/theme_abc123/settings.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "colors_accent_1": "#FF5733",
      "colors_background_1": "#FAFAFA",
      "type_header_font": "Roboto"
    }
  }'

​
Body Parameters

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

​
Response

{
  "success": true,
  "data": {
    "updated": {
      "colors_accent_1": "#FF5733",
      "colors_background_1": "#FAFAFA",
      "type_header_font": "Roboto"
    }
  }
}

​
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

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have write_themes scope
NOT_FOUNDTheme does not exist
VALIDATION_ERRORInvalid setting key or value