Editing

Refine a site with a natural-language instruction

Applies an AI edit to one page (homepage by default). Counts against the workspace’s monthly AI-refinement allowance. Requires scope sites:refine.

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

Request

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

Request body

instructionstring required

Natural-language edit, e.g. "Make the hero headline more confident and add a pricing section".

pagestring

Slug of the page to refine (e.g. "/about"). Omit to refine the homepage.

idempotency_keystring

Optional stable key for one refinement attempt. Reuse it after a timeout to receive the original job instead of queueing a second refinement.

Response

Refinement accepted and queued. Poll GET /api/v1/jobs/{job_id} until status is completed or failed — a refinement typically takes 30–120s. The work runs server-side and completes even if the client disconnects.

site_idstring uuid required
job_idstring uuid required
status'refining' required
messagestring
poll_toolstring

Changes

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