Versions and revisions

Each draft produces a version. When you ask for changes, Wavefront writes the next version of the same piece from your feedback, and the earlier one stays exactly as it was. All versions of a piece share one discussion and one publishing history.

Ask for a revision

1. Open the draft.
2. In the Review box, describe the change in What should change? Be specific: “Lead with the pricing table and cite each source” works better than “make it better”.
3. Choose Request changes and revise.
4. A message says “Revision started”. The new version is checked like any draft and comes back to Review.

If you only want to record feedback without starting a revision, choose Request changes only instead.

A version with blockers can’t be approved, but it can always be revised. Only one revision of a version runs at a time; if one is already being written, the Review box links to it.

Move between versions

When a piece has more than one version, the version picker above the preview lists them all. Pick one to see its preview, its checks and its decision. Each version is approved or not on its own: approving version 3 doesn’t approve version 4.

The Details box shows who created the work, where it came from (the web app, the API or an agent over MCP), when, the documents version it read, and its charge in credits.

Scripts and agents can also compare two versions as a text diff through the API or MCP.

Revisions after publishing

Publishing a later version of the same piece to the same destination updates the existing post. The slug and URL stay the same, so search ranking carries over. The Publishing box reads Update the published page, and its History lists every version sent to each destination.

Approved suggestions from search data also create revisions, for example to expand an article that ranks just off page one. They come back to Review like any other revision. See suggestions and site metrics.

A calendar post that refreshes a page Wavefront published is drafted as a revision of that article too, so publishing it updates the same page.

Who can revise

• Owners and editors can request revisions in the web app.
• API keys with the right scope and agents over MCP can request revisions. They can’t approve the result.
• Viewers can comment but can’t revise.

When an owner turns on auto-revise, autopilot asks for one revision of its own draft when it has blockers. See autopilot and auto-approve.

What a revision costs

A revision is charged like a draft, in credits, for the work it does. If a revision fails because of a problem on our side, it’s free.

If something goes wrong

• The revision ignored part of your note. Request another revision and name the part it missed.
• “A revision is already being written”. Open the link in the Review box and wait for that one.
• The draft stopped at its budget with a partial version. A partial version can’t be approved. Request a revision or start again.