remove_annotations Leave feedback

remove_annotations deletes annotations by ID — or every annotation in the document when ids is omitted. The common use is producing a clean copy to send outside the review circle. Example prompt: “Remove all annotations and give me a clean copy”.

Tool description (as the AI agent sees it):

Removes annotations from a document by ID and saves the result back to storage. Supports PDF, DOCX, XLSX, PPTX, and 50+ more document and image formats. Call get_annotations first to retrieve annotation IDs, then pass them here. Omit ‘ids’ to remove every annotation in the document. Call this tool whenever the user asks to delete, remove, or clear annotations. Do NOT pre-check whether files exist — pass the filename the user provided directly. Returns a saved-path message (‘Removed N annotation(s) from ’). On failure, the response text starts with ‘Annotation removal failed for’ followed by the underlying exception type, message, and inner-exception chain.

{
  "name": "remove_annotations",
  "arguments": {
    "file": {
      "filePath": "contract_annotated.pdf"
    },
    "ids": "3,7"
  }
}

A message naming the saved document and how many annotations were removed.

Omitting ids clears everything — which is exactly what you want before sending a document to a counterparty, and exactly what you do not want in the middle of a review. Ask the agent to confirm the count first.

On failure the text starts with Annotation removal failed for, followed by the exception type and message.

• “Remove all annotations and give me a clean copy to send.”
• “Delete comments 3 and 7 — they are resolved.”
• “Strip the internal review notes but keep the client’s comments.”