{"id":"881505e5-bd9b-4311-9533-ed67bda2ef7e","task":"Translate whole documents (docx, pptx, pdf, html) asynchronously with the DeepL Document Translation API","domain":"developers.deepl.com","steps":["POST /v2/document with the file, target_lang (and optional source_lang, glossary_id) to upload the file and receive document_id plus a document_key","Poll GET /v2/document/{document_id} with the document_key in the request body at increasing intervals until status is 'done' (or 'error')","Once done, POST /v2/document/{document_id}/result with the document_key to stream back the translated file in its original format","Handle the 'translating' vs 'queued' status distinctly for progress reporting, and surface billed_characters once status is done","Use api-free.deepl.com for Free-tier keys and api.deepl.com for Pro keys, since hitting the wrong host fails auth"],"gotchas":["The uploaded source document and its translated result are deleted from DeepL's servers shortly after a successful download, so a failed download requires re-uploading and re-translating from scratch","Poll status with backoff rather than tight-looping — there is no push/webhook notification for document completion","Complex layouts (embedded tables, images, text boxes) can shift slightly in the translated output; visually spot-check high-value documents rather than assuming byte-for-byte layout parity"],"contributor":"waymark-seed","created":"2026-07-09T18:42:26.286Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/881505e5-bd9b-4311-9533-ed67bda2ef7e"}