{"slug":"api-free-deepl-com","name":"api-free.deepl.com","host":"api-free.deepl.com","site":"https://deepl.com","category":"inference","docsUrl":null,"sources":[{"kind":"archive","url":"https://developers.deepl.com/docs/resources/breaking-changes-change-notices/march-2025-deprecating-get-requests-to-translate-and-authenticating-with-auth_key"},{"kind":"archive","url":"https://developers.deepl.com/docs/resources/breaking-changes-change-notices/november-2025-deprecation-of-legacy-auth-methods"},{"kind":"archive","url":"https://developers.deepl.com/docs/resources/roadmap-and-release-notes"}],"url":"https://www.okapi.bot/providers/api-free-deepl-com/","json":"https://www.okapi.bot/api/v1/providers/api-free-deepl-com.json","breakingChanges":[{"slug":"the-auth-key-body-field-stops-working","api":"api-free-deepl-com","title":"The auth_key body field stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-01-15","scope":null,"calls":["body parameter auth_key"],"method":null,"path":null,"source":{"url":"https://developers.deepl.com/docs/resources/breaking-changes-change-notices/november-2025-deprecation-of-legacy-auth-methods","kind":"archive"},"quote":"Update: The deadline for this deprecation has been extended to January 15th, 2026.","migration":"Send the key in the Authorization header: Authorization: DeepL-Auth-Key [yourAuthKey].","migrationChange":null,"needsDecision":null,"text":{"summary":"Starting January 15, 2026, requests to api-free.deepl.com using the body parameter auth_key will fail. DeepL extended the deadline for this deprecation to that date. Any calls continuing to provide authentication through the request body will no longer be accepted.","migration":"Send the key in the Authorization header instead, using Authorization: DeepL-Auth-Key [yourAuthKey].","by":"writer"},"publishedAt":"2026-10-28T14:11:15.790Z","updatedAt":"2026-10-28T16:17:48.238Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/api-free-deepl-com/breaking-changes/the-auth-key-body-field-stops-working/"},{"slug":"the-auth-key-query-parameter-stops-working","api":"api-free-deepl-com","title":"The auth_key query parameter stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-01-15","scope":null,"calls":["query parameter auth_key"],"method":null,"path":null,"source":{"url":"https://developers.deepl.com/docs/resources/breaking-changes-change-notices/november-2025-deprecation-of-legacy-auth-methods","kind":"archive"},"quote":"Update: The deadline for this deprecation has been extended to January 15th, 2026.","migration":"Send the key in the Authorization header: Authorization: DeepL-Auth-Key [yourAuthKey].","migrationChange":null,"needsDecision":null,"text":{"summary":"On January 15, 2026, the query parameter auth_key will stop working for calls to api-free.deepl.com. The deadline for this deprecation has been extended to January 15th, 2026. Any requests passing credentials using the query parameter auth_key after that date will fail.","migration":"Send the key in the Authorization header instead, using Authorization: DeepL-Auth-Key [yourAuthKey].","by":"writer"},"publishedAt":"2026-10-28T14:11:15.790Z","updatedAt":"2026-10-28T16:17:46.565Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/api-free-deepl-com/breaking-changes/the-auth-key-query-parameter-stops-working/"},{"slug":"get-v2-translate-stops-working","api":"api-free-deepl-com","title":"GET /v2/translate stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2025-03-14","scope":null,"calls":["GET /v2/translate"],"method":"GET","path":"/v2/translate","source":{"url":"https://developers.deepl.com/docs/resources/breaking-changes-change-notices/march-2025-deprecating-get-requests-to-translate-and-authenticating-with-auth_key","kind":"archive"},"quote":"You will no longer be able to send GET requests or query parameters to the /translate endpoint. Going forward, /translate will accept only POST requests with data included in the request body.","migration":"Send POST /v2/translate with the text and target_lang in the request body and the key in an Authorization: DeepL-Auth-Key header.","migrationChange":null,"needsDecision":null,"text":{"summary":"On March 14, 2025, GET /v2/translate stops working. The provider will no longer accept GET requests or query parameters on this endpoint, accepting only POST requests with data in the request body. Calls made using GET /v2/translate after that day will fail.","migration":"Send POST /v2/translate with the text and target_lang in the request body and the key in an Authorization: DeepL-Auth-Key header.","by":"writer"},"publishedAt":"2026-10-28T14:11:15.885Z","updatedAt":"2026-10-28T16:17:48.328Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/api-free-deepl-com/breaking-changes/get-v2-translate-stops-working/"},{"slug":"get-v2-glossary-language-pairs-is-deprecated","api":"api-free-deepl-com","title":"GET /v2/glossary-language-pairs is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-05-18","effectiveAt":null,"scope":null,"calls":["GET /v2/glossary-language-pairs"],"method":"GET","path":"/v2/glossary-language-pairs","source":{"url":"https://developers.deepl.com/docs/resources/roadmap-and-release-notes","kind":"archive"},"quote":"/v2/languages and /v2/glossary-language-pairs are now deprecated.","migration":"Use GET /v3/languages with the glossary resource; see the Migrating from v2/languages guide.","migrationChange":null,"needsDecision":null,"text":{"summary":"The provider deprecated the GET /v2/glossary-language-pairs endpoint on May 18, 2026, without announcing a shutdown date. Calls to this endpoint will eventually fail once the removal takes effect. This change affects any integration querying language pairs through the v2 glossary path.","migration":"Use GET /v3/languages with the glossary resource instead. Consult the Migrating from v2/languages guide for details on completing the transition.","by":"writer"},"publishedAt":"2026-10-28T14:11:15.694Z","updatedAt":"2026-10-28T17:17:13.706Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/api-free-deepl-com/breaking-changes/get-v2-glossary-language-pairs-is-deprecated/"},{"slug":"get-v2-languages-is-deprecated","api":"api-free-deepl-com","title":"GET /v2/languages is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-05-18","effectiveAt":null,"scope":null,"calls":["GET /v2/languages"],"method":"GET","path":"/v2/languages","source":{"url":"https://developers.deepl.com/docs/resources/roadmap-and-release-notes","kind":"archive"},"quote":"/v2/languages and /v2/glossary-language-pairs are now deprecated.","migration":"Use GET /v3/languages (and GET /v3/languages/resources); see the Migrating from v2/languages guide.","migrationChange":null,"needsDecision":null,"text":{"summary":"DeepL has deprecated GET /v2/languages without a shutdown date. Calls targeting this endpoint will eventually fail once it is removed. The provider announced on May 18, 2026, that the endpoint is deprecated alongside glossary language pairs.","migration":"Use GET /v3/languages and GET /v3/languages/resources instead. Consult the Migrating from v2/languages guide for details on completing the transition.","by":"writer"},"publishedAt":"2026-10-28T14:11:15.694Z","updatedAt":"2026-10-28T17:17:13.703Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/api-free-deepl-com/breaking-changes/get-v2-languages-is-deprecated/"}]}