Add a page to a site
add_pageAdds a new page (e.g. "/about", "/contact") to an existing site, built from html (same importer as create_site_from_html) or composed from sections/content_json in the site's own palette and fonts. Link between pages with href="/about". Respects the plan's page limit; stage:true previews it before it goes live. Free.
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": {
"path": "<path>"
},
"name": "add_page"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | No | Build the page from this HTML (same importer as create_site_from_html). Omit to compose it from sections instead. | |
| name | No | The page name shown in the editor's page list. Defaults to one made from the path ("Contact Us"). | |
| path | Yes | The new page's path, e.g. "/about" or "/contact": lowercase letters, digits and hyphens, at most 19 characters. Link to it with href="/about". | |
| stage | No | true = work on a staged copy instead of the live site: preview it at staged_preview_url, then publish_staged or discard_staged. Omit for a normal (immediately live) edit. | |
| sections | No | Comma-separated section kinds to compose the page from when html is omitted: hero, about, services, features, gallery, testimonials, pricing, faq, hours, contact, cta, footer, menu, map, social, header, products, reviews. Defaults to about. | |
| site_key | No | The site to add a page to. Defaults to the caller's current draft site when omitted. | |
| draft_token | No | The draft token returned by draft_create, if you are working on an anonymous draft. Only needed when your client cannot send the x-pagetool-draft-token header. | |
| content_json | No | Per-section content keyed by section kind, exactly as create_site_from_brief's content_json. Styled with the site's own palette and fonts. |