Update Header
update_headerUpdate the site header — navigation, CTA button, layout variant, announcement bar, logo size, background colour. The header appears on every page.
Annotations: read-only=false, destructive=true, idempotent=true, open-world=false. Why: Overwrites the draft's header and navigation settings — non-additive, so destructive by the MCP definition; idempotent; 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>"
},
"name": "update_header"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cta | No | Header CTA button (e.g. "Get a Free Quote") | |
| site_id | Yes | ||
| variant | No | ||
| logo_size | No | Header logo size — "small" | "medium" (default) | "large". Sizes the logo image or business-name text on every layout, desktop and phones. "Bigger" = one step up from the current size (read_site → header.logo_size). | |
| nav_items | No | ||
| background | No | Header background (ZAR-2060) — "default" (the page colour) | "alt" (soft) | "primary" (the brand colour) | "dark" (dark surface). Null clears it back to the page colour. Choosing a preset also clears any custom colour (a custom colour would otherwise win). Links, the phone, the logo text and the phone menu adapt automatically. A see-through / transparent header is not supported. | |
| show_phone | No | Show phone number in header | |
| background_color | No | Custom header colour as a 6-character hex (e.g. "#0f172a"); overrides the preset. Null clears it. Text adapts automatically (read_site → header.background / header.background_color). | |
| announcement_items | No | Announcement strip shown above the header on every page, e.g. ["Free shipping over $80", "Ships Australia-wide"]. Null or empty clears it. |