apply_landing_page_ops
Applies edit operations to the draft of the landing page, never to the live page. Free pages and pages in the page model take different operations: see get_landing_catalog. If one operation is rejected nothing changes.
| Tool name | apply_landing_page_ops |
| Permission | landing:write |
readOnlyHint | false |
destructiveHint | false |
idempotentHint | true |
openWorldHint | false |
| REST call | POST /v1/landing-page/operations |
#What it does
- Changes data in your account. It does not send messages to contacts.
- Safe to repeat with the same idempotency_key.
#Input
The tool takes one flat object. Path, query and body fields of the REST call are merged into it.
| Name | Type | Required | Description |
|---|---|---|---|
operations | array of object | yes | The operations, applied in this order. up to 50 items |
operations[].type | string | yes | Kind of operation. See get_landing_catalog. one of: replace_text, set_page_title, set_page_description, set_design_token, add_section, update_section_data, change_variant, move_section, delete_section, set_style, set_settings, replace_media |
operations[].find | string | no | replace_text: the text to find. It must occur exactly once in the page. up to 2000 characters |
operations[].replace | string | no | replace_text: the new text (plain text). up to 2000 characters |
operations[].text | string | no | set_page_title (up to 160 characters), set_page_description (up to 300), replace_text in the page model (the new text). up to 2000 characters |
operations[].token | string | no | set_design_token: name of an existing design value, for example --brand-color. up to 41 characters |
operations[].value | string | no | set_design_token: a color (#hex, rgb(), hsl()) or a length (px, rem, em, %). up to 60 characters |
operations[].id | string | no | Page model: id of the section or element (from get_landing_page include=sections). up to 40 characters |
operations[].field | string | no | Page model: field name, for example title or items[0].title. up to 100 characters |
operations[].section | object | no | add_section: the new section. kind block with type, variant and data, or kind free with layout and elements. See get_landing_catalog. |
operations[].position | object | no | add_section: where the section goes. Default: at the end. |
operations[].position.at | string | no | The start or the end of the page. one of: start, end |
operations[].position.index | integer | no | Place number, counted from 0. 0 to 100 |
operations[].position.after | string | no | Id of the section it goes after. up to 40 characters |
operations[].position.before | string | no | Id of the section it goes before. up to 40 characters |
operations[].to | object | no | move_section: the new place. |
operations[].to.at | string | no | The start or the end of the page. one of: start, end |
operations[].to.index | integer | no | Place number, counted from 0. 0 to 100 |
operations[].to.after | string | no | Id of the section it goes after. up to 40 characters |
operations[].to.before | string | no | Id of the section it goes before. up to 40 characters |
operations[].data | object | no | update_section_data: fields to change. A value null removes the field. |
operations[].variant | string | no | change_variant: the new variant of the section. up to 40 characters |
operations[].style | object | no | set_style: style values to change, for example palette or mood. |
operations[].settings | object | no | set_settings: settings to change. language sets the one language of the page. |
operations[].url | string | no | replace_media: address of the new image (https, from the media library of the account). up to 2000 characters |
operations[].alt | string | no | replace_media: short description of the image. up to 200 characters |
operations[].decorative | boolean | no | replace_media: true if the image only decorates. |
operations[].origin | string | no | replace_media: origin of the image. Always own. one of: own |
dry_run | boolean | no | True: check and show the changes, write nothing. |
Arguments added by the MCP server (see Special arguments)
| Name | Type | Required | Description |
|---|---|---|---|
idempotency_key | string | no | Optional. Unique key, for example a UUID. Same key and arguments within 24 hours: first result. up to 255 characters |
#Result
The result has the same content as the REST answer. Lists have at most 50 items per page (default 20); use cursor for the next page.
Errors come back as a tool result with isError: true. The error codes are the ones in Errors.