Build with Mondovo

Creates a site from a structured brief and starts generation in the background (~60s). Returns 202 immediately — poll the site until status is ready. Pass an idempotency_key so a retried timeout returns the original site instead of creating a duplicate.

curl -X POST https://app.mondovo.com/api/v1/sites \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Bright Path Physio",
    "business": {
      "industry": "physiotherapy",
      "location": "Austin, TX",
      "description": "Sports injury and rehab clinic."
    },
    "design": { "style": "clean, modern", "color_palette": { "primary": "#0f766e" } },
    "goal": "book an appointment",
    "idempotency_key": "3f9d2c1a-7e54-4b0e-9a1f-2b6c8d0e4f5a"
  }'

HTTP/1.1 202 Accepted
{
  "site_id": "5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f",
  "status": "generating",
  "estimated_seconds": 60,
  "poll_url": "/api/v1/sites/5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f"
}

Lists your organization’s sites, most recent first (up to 50).

curl https://app.mondovo.com/api/v1/sites \
  -H "Authorization: Bearer mk_live_..."

HTTP/1.1 200 OK
{
  "sites": [
    {
      "site_id": "5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f",
      "name": "Bright Path Physio",
      "status": "ready",
      "preview_url": "https://app.mondovo.com/preview/abc123",
      "pages": ["/", "/about", "/contact"],
      "created_at": "2026-07-24T10:00:00Z"
    }
  ],
  "total": 1
}

Returns status, generation progress, a shareable preview_url, an editor_url, the live deployment_url once published, and page slugs. Use this to poll while status is generating or publishing.

curl https://app.mondovo.com/api/v1/sites/5f8a1c2e-... \
  -H "Authorization: Bearer mk_live_..."

Applies an AI edit to one page (page defaults to the homepage). Counts against your monthly AI-edit allowance; if the change can’t be saved, no allowance is consumed.

curl -X POST https://app.mondovo.com/api/v1/sites/5f8a1c2e-.../refine \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "instruction": "Make the hero headline more confident and add a FAQ section", "page": "/" }'

HTTP/1.1 200 OK
{
  "site_id": "5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f",
  "status": "refined",
  "message": "Site has been refined successfully.",
  "poll_url": "/api/v1/sites/5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f"
}

Deploys the site to https://<subdomain>.mondovo.site (custom domains attach in the dashboard). If the site still carries AI-generated placeholder contact details you’ll get a 422 — fix them via refine, or resend with confirm_contact_info: true. See billing notes for the first-publish 402.

curl -X POST https://app.mondovo.com/api/v1/sites/5f8a1c2e-.../publish \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "subdomain": "bright-path-physio" }'

HTTP/1.1 200 OK
{
  "site_id": "5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f",
  "status": "published",
  "deployment_url": "https://bright-path-physio.mondovo.site",
  "message": "Site published successfully."
}

Pass any HTTPS URL — including an expiring signed URL — and Mondovo downloads the file, stores it permanently on our CDN, adds it to the site’s asset library, and returns a stable URL. Images (JPG/PNG/WebP/GIF, max 20 MB) and video (MP4/WebM/MOV, max 80 MB; optimized for the web after upload).

curl -X POST https://app.mondovo.com/api/v1/sites/5f8a1c2e-.../assets \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/clinic-hero.jpg", "alt_text": "Clinic reception" }'

HTTP/1.1 200 OK
{
  "site_id": "5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f",
  "asset_id": "9c2d4e6f-...",
  "url": "https://site-assets.mondovo.com/sites/5f8a1c2e-.../uploads/aB3xY9....jpg",
  "type": "image",
  "mime_type": "image/jpeg",
  "bytes": 482113,
  "message": "Stored the image permanently. Use the returned url — it will not expire."
}

Soft-deletes a draft site. Published sites can’t be deleted via the API — unpublish first from the dashboard.

curl -X DELETE https://app.mondovo.com/api/v1/sites/5f8a1c2e-... \
  -H "Authorization: Bearer mk_live_..."

HTTP/1.1 200 OK
{ "deleted": true, "site_id": "5f8a1c2e-1234-4b6f-9d3e-0a1b2c3d4e5f" }