Switch Design
switch_designMove the site onto a marketplace design from list_designs. FULL REDESIGN: the design's colors, fonts, section layouts and section order come across on the home page AND every internal page, while the site's business details, words, photos, services, forms and pages stay. Sections the design has that the site has no content for are left out (nothing is invented); the site's own sections the design has no spot for are kept. A backup of the current site is saved automatically FIRST — the response reports it under "backup" (restorable via Site Backups in the Zarla editor); if backup.created is false with skipped_reason "snapshot_failed", warn the user the switch proceeded WITHOUT a backup. The response includes a "preview_url" for the updated draft — share THAT link, do not construct your own. Nothing changes on a live site until publish_site. For colors or fonts only, use update_design.
Annotations: read-only=false, destructive=true, idempotent=false, open-world=false. Why: Replaces the draft's design preset (content is kept) — non-additive, so destructive by the MCP definition. Not idempotent: a backup of the previous design is saved before every switch, so a repeat adds another backup row. Closed-world. The live site changes only when the user confirms publish_site; the draft stays editable in the Zarla editor.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site_id": "<site_id>",
"schema_key": "<schema_key>"
},
"name": "switch_design"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site_id | Yes | ||
| schema_key | Yes | The design's schema_key from list_designs |