For AI agents: a machine-readable documentation index for this API is available at /llms.txt. Every page is also available as Markdown: append ".md" to the URL or send an "Accept: text/markdown" request header.

Change a copy of a Word, PowerPoint or Excel file (replace text, insert, change cells, append rows)

Saves the changes as a NEW file; the source is never changed. The kind of the file in the path decides the fields. .docx: edits ([{ find, replace }], exact text), inserts (a paragraph list, a table or a picture by file id of a PNG, JPG or GIF, placed after some text or at the end), track_changes (the changes become tracked changes by Tarkle that the person accepts or rejects in Word). .pptx: edits ([{ find, replace }] on every slide where the text appears). .xlsx: cells ([{ sheet, cell, value }], up to 100) and append_rows ([{ sheet, rows }], up to 200 rows); a cell with a formula, a merged cell, or a workbook with charts, pictures, pivot tables or macros is refused. Every text, anchor or sheet named must exist: 422 unprocessable_file with details.not_found, details.anchors_not_found and details.sheets_not_found. Needs files:write; 20 calls a minute per token.

What you provide

  • Editsoptional: Exact text to find and its replacement (empty deletes), up to 50 for Word and PowerPoint
  • Insertsoptional: Word only
  • Track changesoptional: Word only: record the changes as tracked changes by Tarkle
  • Cellsoptional: Excel only, up to 100; an empty value clears the cell
  • Append rowsoptional: Excel only, up to 200 rows in all
  • Nameoptional: The new file's name; default '<name> (edited).<ext>'
  • Folder idoptional: The folder; omitted keeps the source's folder

Do this with AI

I want to change a copy of a Word, PowerPoint or Excel file (replace text, insert, change cells, append rows). Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/editofficefile.md Authenticate with your API key as a Bearer token in the Authorization header. Then make the request for me and tell me what came back.

Paste this into Claude, Cursor, or any AI assistant and it will do it for you.