The GenPolish API is not open yet. API keys are not available, so the examples below cannot be run. Contact us if you are interested.

GET /revisions

List the stored polishes of a document, newest first. Reading revisions never consumes quota.

Request

documentIdstring

Optional. Omit it to list every revision you can read.

limitinteger

1 to 100. Defaults to 20.

The query string is read leniently, unlike the JSON body of /polish: a browser or an extension sometimes carries a cache-busting parameter, and answering 400 to that helps nobody.

Example

cURL

curl "https://api.genpolish.app/v1/revisions?documentId=q3-launch-email&limit=5" \
  -H "Authorization: Bearer $GENPOLISH_KEY"

Response

ninteger

Revision number, increasing from 1.

tonestring

The tone the polish ran with.

changesinteger

How many edits it applied.

scoreinteger

Human score after the polish, 0–100.

currentboolean

The revision served when the document opens.

Next: Errors

No key yet? The same engine runs in the browser, on a draft you paste, and shows every change before it is applied — polish a draft without an account.