Pages
save_page
Author or replace a single page in the site's current draft, opening a draft from the published version if none exists. If you have not read the Sentway authoring guide in this session, call get_authoring_guide first for the authoring conventions (page types, paths, assets). Every site needs a homepage at path '/' ('/index' is an ordinary page and does NOT serve at the site root); the returned homepage_missing tells you whether one still has to be written. Use when adding or fully replacing one page's source. Do not use to patch fragments or to publish.
Behaviour
- Effect
- Destructive. It can remove or overwrite existing data.
- Repeat calls
- Idempotent. Repeating the same call produces the same result.
- Plan
- Available on every plan, including free.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| request_id | string | Yes | Unique mutation ID; reuse only to replay identical arguments, new ID after E_CONFLICT. |
| site_id | uuid | Yes | Site UUID from list_sites. |
| path | string | Yes | Page URL path, e.g. '/pricing'. Leading slash required. '/' is the site's homepage; '/index' is an ordinary page and will NOT serve at the site root. |
| page_type | enum html | jsx | markdown | svg | mermaid | Yes | Page source language: html, jsx, markdown, svg or mermaid. |
| source | string | Yes | Complete replacement source for the page. UTF-8, maximum 500 KB. |
| title | string or null | Yes | Page title, or null. Maximum 200 characters. |
| if_revision | string or null | Yes | Selected revision from get_site, list_pages or get_page; null only when source is none. Refresh on E_CONFLICT. |
| shell | object | No | Embed shell settings. Only valid when page_type is svg or mermaid. |
Returns
| Name | Type | Description |
|---|---|---|
| page | object | - |
| content | object | - |
| idempotency_replay | boolean | - |
| homepage_missing | boolean | TRUE when the site's current authoring version has no page at '/'. A site with no '/' page 404s at its root URL. '/index' does not count. |
Using it
save_page is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 56 Sentway tools. See connecting over MCP.