Update theme settings

Replaces the theme’s global settings.

PUT/themes/{theme_id}/templates/settings

Authorization

AuthorizationBearer token (JWT) · headerrequired

Path parameters

theme_idstringrequired

Theme ID

Request body

requiredapplication/json

settings_jsonstringrequired

JSON string containing the theme settings blob

Responses

200

Settings updated; returns the settings template stub

_linksHalLinks

idstring

file_namestring

pathstring

bodystring

Full template source code

is_sectionboolean

schemaobject

Present only when is_section is true — the section's configurable schema.

parent_commitstring | null

updated_onstring<date-time>

401

Unauthorized

403

Access denied

422

Validation error

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

theme_idpath*Theme ID

Bodyapplication/json

settings_jsonstring*JSON string containing the theme settings blob

Request

curl -X PUT 'https://api.onbolder.com/v2/themes/abc123/templates/settings' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "settings_json": "{\"color\":\"#ff0000\",\"font\":\"Helvetica\"}"
}'

const response = await fetch("https://api.onbolder.com/v2/themes/abc123/templates/settings", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"settings_json\": \"{\\\"color\\\":\\\"#ff0000\\\",\\\"font\\\":\\\"Helvetica\\\"}\"\n}"
});

import requests

response = requests.put(
    "https://api.onbolder.com/v2/themes/abc123/templates/settings",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"settings_json\": \"{\\\"color\\\":\\\"#ff0000\\\",\\\"font\\\":\\\"Helvetica\\\"}\"\n}",
)

Response

{
  "_links": {
    "property1": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    },
    "property2": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    }
  },
  "id": "string",
  "file_name": "layout.html",
  "path": "string",
  "body": "string",
  "is_section": true,
  "schema": {},
  "parent_commit": "string",
  "updated_on": "2019-08-24T14:15:22Z"
}