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