Publishing

Publish a site to the web

Compiles and deploys the site to its platform address (e.g. https://<subdomain>.mondovo.com; the exact URL is returned as deployment_url), or to its custom domain once one is attached and verified in the dashboard. Requires scope sites:publish.

Billing: taking a site live adds the standard per-site monthly charge to the subscription. The account owner must confirm that charge once, in the Mondovo editor — the API cannot consent to new recurring billing, so the first publish of a billable site returns 402 billing_confirmation_required. After the charge is confirmed (or on plans/sites where no new charge applies), API publishes go straight through.

post/api/v1/sites/{id}/publish

Request

  • Base URL: https://app.mondovo.com
  • URL: https://app.mondovo.com/api/v1/sites/{id}/publish
  • Auth: HTTP bearer

Request body

subdomainstring

Desired subdomain (the site goes live at its platform address, e.g. https://<subdomain>.mondovo.com — the exact URL is returned as deployment_url). Only applied if the site has no subdomain yet; omitted → auto-derived from the site name.

confirm_contact_infoboolean

Publishing is paused (422 contact_info_needs_confirmation) while the site still carries AI-generated placeholder contact details. Set true to acknowledge the warning and publish anyway — retrying without it never clears the guard.

Response

Published.

site_idstring uuid required
status'published' required
deployment_urlstring uri required
messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.