Update Block
update_blockUpdate the content of a specific block on a page. Blocks are the building sections — hero, features, testimonials, FAQ, etc. You can update text, images, items, CTAs, and layout variant.
Annotations: read-only=false, destructive=true, idempotent=true, open-world=false. Why: Overwrites one section's content or settings on the DRAFT — 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>",
"page_slug": "<page_slug>",
"block_id": "<block_id>"
},
"name": "update_block"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cta | No | ||
| image | No | `{ url, alt, focus?, zoom? }` — `focus` is the point of the photo that must stay in view ({x, y} each 0–1 from the left/top; 0.5/0.5 = centre) and `zoom` (1–2) enlarges around it. The object replaces the field whole: sending `url` alone starts the photo centred at 1×; to reframe the current photo, resend its `url` and `alt` with the new `focus`/`zoom`. Both apply on every layout, including the photos behind a hero's text and the call-to-action banner. Values outside the ranges are rejected. | |
| items | No | Repeating items (features, testimonials, FAQ, etc.) | |
| images | No | Per-slot images for multi-image layouts (collage, split-duo, bottom-slider) — same shape as `image`, framing included. | |
| content | No | Full content replacement — overrides all above fields | |
| site_id | Yes | ||
| variant | No | Layout variant — see list_block_types | |
| block_id | Yes | Block ID from get_site or get_page (e.g. block-0, block-1) | |
| headline | No | ||
| page_slug | Yes | Page slug | |
| background | No | Section background — "default" (page colour) | "alt" (soft) | "primary" (brand colour) | "dark" (dark surface). Null clears it. Choosing a preset also clears any custom colour (a custom colour would otherwise win). | |
| subheadline | No | ||
| background_color | No | Custom section colour as a 6-character hex; overrides the preset. Null clears it. Text adapts automatically. |