Have Mondovo generate an alternative design
generate_design_variationAsk MONDOVO to generate an ADDITIONAL design variation for an existing site — an alternative layout the user can compare and switch to. This APPENDS a new variation (never overwrites the current design). Use this when the user wants "another option" but does NOT want you to author it; to author the alternative yourself instead, use import_design_variation. It is a WHOLE-SITE design — to try another version of ONE page (the home page included), use create_page_draft instead. TWO MODES. Omit clone_index and Mondovo generates a design deliberately DIFFERENT from every existing one (the user is collecting options to compare). Pass clone_index and Mondovo builds a SIBLING of that specific design instead — same style personality, palette and type, varying layout and composition. THIS IS THE RIGHT TOOL FOR "make another one like design N" or "same look, different layout". You do not need to read a design's source to build on it: name its index here and Mondovo generates from it server-side. Call get_render_diagnostics first if you want to SEE the design you are building on. Returns 202; poll get_site until status is "ready".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site_id | Yes | The existing site to add a Mondovo-generated variation to | |
| guidance | No | What should differ in this variation, e.g. "same look but swap the objections section for a tighter 3-item ledger". Most useful together with clone_index. | |
| user_goal | No | Optional: the user's goal behind this call, in one short sentence of plain words (e.g. "add a page so customers can book tables"). No names, emails or other personal details. | |
| clone_index | No | Variation index (from list_variations) to build a sibling of. Omit for a deliberately different design. | |
| reference_image_url | No | A design reference image for Mondovo to work from — an https URL or a data:image/... URI. Mondovo reads it and takes its palette, typography, spacing and composition as controlled inspiration; it does not copy the image into the page. Omit to generate without one. When you pass clone_index and the design you are cloning was itself built from a reference, that reference carries over automatically, so you only need this to introduce a NEW one. |