page_draft
Build storefront pages section by section in a local draft, then commit incrementally to avoid timeouts. Inspect, list, or clear drafts before publishing.
Instructions
Build a page section by section in a draft, then commit it as one save. Pick the operation with action and pass that action's arguments (help:true returns its full documentation and schema).
start_page_draft: Start a page draft (no network).
add_draft_section: Append ONE section to a local page draft (NO network — this is the durable per-section cache step that can't time out).
get_page_draft: Inspect a local page draft: its meta, the section ids, total section count, and (if a commit is in progress) the page_id + committed_count.
list_page_drafts: List local page drafts for the current site (summaries only: id, name, slug, type, section count, commit progress, updated_at).
commit_page_draft: Persist a local page draft to the backend INCREMENTALLY (one section per request, 120s timeout each) so no single huge request can time out.
clear_page_draft: Delete a local page draft (does NOT delete any backend page already created from it).
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": {
"action": "<action>"
},
"name": "page_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seo | No | SEO for this page → settings.seo (applied on commit). [start_page_draft] | |
| help | No | Return the action's full documentation and argument schema instead of running it | |
| name | No | Page name [start_page_draft] | |
| slug | No | URL slug WITHOUT a leading slash, e.g. [start_page_draft] | |
| type | No | Page kind. SPECIAL pages need a site data-source enabled on commit: store→use_store, member→use_m… [start_page_draft] | |
| action | Yes | Which operation to run | |
| dry_run | No | Validate+preview only (true) or create+persist incrementally (false) [commit_page_draft] | |
| section | No | A section node (from new_section) — object or JSON string [add_draft_section] | |
| draft_id | No | Draft id from start_page_draft [add_draft_section, get_page_draft, commit_page_draft, clear_page_draft] | |
| is_homepage | No | Set as the site homepage on commit [start_page_draft] |