Repaint a site's theme
set_themeRepaints the palette and fonts of an existing site across every section without touching its content or structure - the tool for make it warmer, darker, more corporate. At least one of palette_primary, palette_neutral, font_heading, font_body is required. Free, and no account is needed for a draft you created.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "set_theme"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage | No | true = work on a staged copy instead of the live site: preview it at staged_preview_url, then publish_staged or discard_staged. Omit for a normal (immediately live) edit. | |
| site_key | No | The site to theme. Defaults to the caller's current draft site when omitted. | |
| font_body | No | New body font family name. | |
| draft_token | No | The draft token returned by draft_create, if you are working on an anonymous draft. Only needed when your client cannot send the x-pagetool-draft-token header. | |
| favicon_url | No | The browser-tab icon for the site: an https:// image URL (or a /path on the site), max 500 characters. May be the only field. Without one, customer domains show the first letter of the site name on its primary colour. | |
| font_heading | No | New heading font family name. | |
| palette_neutral | No | New neutral text/background colour as a #rrggbb hex string. | |
| palette_primary | No | New primary brand colour as a #rrggbb hex string. |