Replace a page's content
update_pageReplace the content of an existing page in place: the same URL serves the new content immediately, so links the human already shared keep working. Use this instead of publish_page whenever the page already exists. The previous version stays restorable from the dashboard for 7 days (Pro keeps full version history). Pass draft: true to stage the update instead: nothing changes for viewers until the maker reviews the previewUrl and presses "Sync to live"; use it when the human asked to see changes before they go out. Fails with page_not_found if the id is not a live or offline page in this space, and with secrets_detected (nothing changes) if the new content looks like it holds live credentials. A page that works as a sign-in or payment form sending what people type to another site can be refused with unsafe_page_detected (no override): make such forms non-functional demos. Connected without an API key, it updates a preview instead: pass the claim_token that publish_page returned (or omit it in the same session that published the page). The URL stays the same and the 7-day expiry does not move; previews have no drafts or version history. After the human claims the preview (claim_page), a page that moved into their account answers preview_already_claimed: reconnect with their API key to keep updating it. Pages that did not fit their plan stay previews and the claim token still updates them.
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": {
"page_id": "<page_id>",
"html": "<html>"
},
"name": "update_page"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | Yes | The complete new document (not a diff). HTML, or Markdown when source_type is "markdown". | |
| draft | No | Default false (publishes live instantly). true = stage the update; relay the returned previewUrl so the human can review and press Sync. A new draft replaces any pending one. | |
| title | No | Optional; omit to keep the existing title. | |
| page_id | Yes | The page id: the `id` field from publish_page or list_pages (also the last path segment of the page URL, …/docs/<page_id>). Only pages in the connected maker's space are visible. | |
| project | No | Optional; omit to keep the existing project. | |
| claim_token | No | Keyless previews only: the claimToken publish_page returned for this page. Ignored when connected with an API key. | |
| source_type | No | Default "html". |