iter0

For developers integrating the iter0 API: check that the API and its developer contracts are reachable. Does not build or edit websites.

Build a new website in the person's iter0 account from a brief, a reference URL they are allowed to use, or a directionId from their Show 3 set. Costs 1 credit. The first call returns a price quote and starts nothing; the build starts only when the person confirms that quote, in the iter0 card or by saying yes in chat, and iter0_confirm_paid_action redeems it. The iter0 card shows the price, the b

Make one focused change to a saved iter0 design: pass its designId and the change as prompt. iter0 loads the current page itself and saves the edit as the design's current page; the card offers Undo. For a page the person pasted into the chat (no designId), pass that page exactly as currentHtml; the revised HTML comes back and no saved design changes. Costs 0.5 credits. The first call returns a pr

Check an authenticated website build; request HTML only when needed.

Return iter0's official links for its API documentation, OpenAPI spec, MCP setup, authentication and support contact. Use when someone asks where to find them. Read-only; does not build or edit websites.

Prepare three rough draft website design directions for the person's business from approved design references; pass the brief and a name and short summary for each direction. Costs 1 credit on a paid account; free accounts use their free allowance. A paid request first returns a price quote and starts nothing; the designs start only when the person confirms that quote, in the card or by saying yes

Read a Show 3 batch. Returns its running or failed status, or when done three directions, each with a stable directionId, title, one-line summary, screenshot URL, preview link and the iter0_create_site arguments that build it. Read-only; charges nothing.

Start a quoted iter0 request once the person has confirmed its price: pass the quote's confirmation (quoteId, name, arguments, credits) unchanged, and exactly the quoted credits are spent. iter0 checks that the quote belongs to the connected account, matches the same request and price, has not expired and has not been used. Work that fails is refunded.

Open the person's iter0 projects: their recent designs, search and a box to start a new website. Use when they ask to open iter0 or see their iter0 projects. Read-only; starts nothing and spends no credits. Covers only the person's own iter0 websites and designs, not general design, colour, logo or branding advice, hosting elsewhere or domains. iter0 does not sell credits or take payment through C

List one page of the person's saved iter0 designs, newest first, with each design's name and link; the card shows their previews. A finished build appears here as a saved design, so this finds a design they name (for example "the Shiplog site") or shows whether a build they started is finished. query searches by name; nextCursor, passed back as cursor, gives the next page. Read-only. Covers only t

Read one of the person's iter0 designs: its name, link, section IDs and labels, and its headline and a short summary as text; the card shows the design. The page's code is not returned. iter0_edit_site takes this designId and the change as prompt, loads the page itself, saves the edit as the design's current page, and the card offers Undo. Read-only. Covers only the person's own iter0 websites and

Used by the iter0 card. Returns a light copy of an owned design's page (images and scripts removed) in widget-only metadata, so the card can outline a section when the person points at the preview. Read-only.

Restore an earlier saved version of the person's site (a versionId from iter0_get_design). Free. Two steps: a call without confirmationToken changes nothing and returns which version replaces which, with a confirmation token; a second call with the same designId, versionId and that token, once the person agrees, restores it.

Undo the last saved edit from the iter0 card. Free. Puts back the exact page from before that edit, which iter0 kept, only while the edit is still the design's current page and the undo has not expired.

Check a saved site for problems before the person shares it. Free and read-only: it changes nothing and uses no credits. Pass the designId. It lists, in plain words, a missing page title or description, images with no alt text, links to pages or sections that do not exist, leftover sample text (lorem ipsum, "your headline here", TODO notes, example.com addresses), contact forms whose messages woul

Puts a saved site live at its own free address, name.iter0.app, so anyone can open it. Free: it uses no credits. Takes the designId and, optionally, a name for the address (lowercase letters, numbers and hyphens, 3 to 63 characters; without one, iter0 uses the free address it suggests). Called without confirmationToken, nothing goes live: it returns the exact address and a confirmationToken. Calle

Takes a live site offline: its address stops working. Free. The saved design and the address are kept, so the site can be published again later. Called with only the designId, nothing changes and it returns a confirmationToken. Called again with the same designId and that confirmationToken, the site goes offline. If the result says the outcome is unknown, iter0_publish_status shows whether the sit

Checks whether a saved site is live. Read-only: it changes nothing and uses no credits. Returns whether the site is published, when iter0 last confirmed that the address loads (an earlier check, not one made now), whether the live copy is the saved version, and the free address on offer if it was never published.

Put a website you built, as finished HTML pages, on the person's iter0 canvas so they can comment on it, ask questions and leave notes there. Free: it uses no credits and publishes nothing. The first push for a sourceId creates the site (one saved design per page, grouped in a project) and returns its designId and one canvasUrl that shows every page as a frame. Later pushes with the same sourceId

Read what the person left on an iter0 canvas: comment threads with their replies (pinned to a page element, a page, a note or a spot), sticky notes, text, shapes and labelled arrows, and durable pins. Each item names the page it is on or near (pageKey, route, designId) and, for element comments, whether that element is still on the current page (anchor.state) and whether the page changed after the

Add a reply to one comment thread or pin on the person's iter0 canvas, for example to answer their question or say what you changed. Free. It only appends the reply, marked as an agent's: it never resolves, reopens or deletes anything and approves nothing. operationId makes a retry safe: the same operationId and text add the reply once. Pass the thread's version from iter0_get_canvas_feedback as e

Read the current HTML of one page on an iter0 canvas, with its version, so you can merge the person's own edits before pushing a revision. Free and read-only. A large page comes in parts: html holds the characters from htmlOffset, and while nextOffset is not null, call again with it as offset and append. Check that version is the same on every part.