merge Leave feedback

merge combines two to four documents into one and saves the result. All inputs should be the same format family — all PDFs, or all DOCX. Example prompt: “Merge these three PDFs into one document.”

Tool description (as the AI agent sees it):

Merges 2–4 documents into a single file and saves the result to storage. Supports PDF, DOCX, XLSX, PPTX, and 30+ more document, image, and archive formats. All inputs should be the same format family for a clean merge (e.g. all PDFs, or all DOCX). Call this tool immediately whenever the user asks to merge, combine, or join documents together. Do NOT pre-check whether files exist — just pass the filenames the user provided. Returns a saved-path message (‘Merged + into “_merged.”’) and the download URL or storage path. On failure, the response text starts with ‘Merge failed for’ followed by the underlying exception type, message, and inner-exception chain.

{
  "name": "merge",
  "arguments": {
    "file1": {
      "filePath": "part-one.pdf"
    },
    "file2": {
      "filePath": "part-two.pdf"
    },
    "file3": {
      "filePath": "appendix.pdf"
    }
  }
}

A saved-path message naming the merged document in your output folder. The sources are untouched.

Order is the argument order: file1, then file2, and so on — so “put the appendix last” is a matter of which slot it occupies, and worth stating in the prompt.

For more than four documents, merge in rounds and chain each result into the next call. For mixed formats, convert first — see the FAQ.

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

• “Merge part-one.pdf and part-two.pdf into a single document.”
• “Combine these three reports, with the appendix last.”
• “Join the signed pages into one PDF for the archive.”

See it used end-to-end: Merge documents with AI agents.