Skip to main content
To add tracked changes to a Word file programmatically, upload it and request the edit with operation: "edit", saying in prompt that you want it “with tracked changes”, and with quality: "standard" or "best". Each change is marked under “Doconda”, so whoever opens it in Word can accept or reject it.

Steps

  1. Store your API key in DOCONDA_API_KEY and install the SDK (pip install doconda or npm install @doconda/sdk).
  2. Upload the Word file with files.upload.
  3. Request the edit with tracked changes and download the result.

What you get back

  • The same Word file with each change marked as a revision under “Doconda”. The rest of the document stays identical.
  • New content copies the document’s formatting: an added clause follows the numbering and look of the existing ones.
  • Its PDF, and a report (documents.report(id)): the result is reviewed just like in Review.
  • status: ready, ready_with_warnings, needs_review or failed. If the request can’t be turned into changes, it ends in failed with edit_not_understood and isn’t charged.

Limits

  • Tracked changes and comments need standard or best; fast doesn’t do them.
  • 50 pages maximum.
  • .doc is accepted too: the result comes out as .docx.

FAQ

Yes. In Word you can ask for tracked changes, add comments or accept pending changes, in the same prompt sentence.
Yes, ask for it in the prompt (“accept all pending changes”) with operation: "edit".
Yes: pass its id (doc_…) in file instead of uploading it.
With extract it comes out as Markdown, with the changes accepted.

Keep reading