An Azure service that turns documents into usable data. Previously known as Azure Form Recognizer.
HTTP 410 / Gone with The requested API version has been retired means the API version in the request is no longer supported by Azure Document Intelligence.
For Azure Document Intelligence:
- v2.1 end of support: September 15, 2027
- v3.0 (
2022-08-31) end of support: March 30, 2029 - v4.0 (
2024-11-30) is the current GA version
Recommended action:
- Check the
api-versionvalue in the REST call or SDK configuration. - If the request is using an older or retired version, update it to
2024-11-30v4.0. - If the application is on v3.0, it can move directly to v4.0 by using the current language-specific SDK and the
2024-11-30REST API. - If this started suddenly across a previously working deployment, also check for a service issue in Azure status or Azure Service Health.
If Java SDK is being used, note that:
-
azure-ai-documentintelligence1.0.0 supports2024-11-30 - version 1.0.7 of the Java library defaults to
2024-07-31-previewunless configured otherwise
If .NET or Python SDK is being used and more detail is needed, enable SDK logging to capture the exact request version being sent:
- .NET throws
RequestFailedExceptionwith the service HTTP status code. - Python can enable
logging/logging_enablefor request details. Be careful with PythonDEBUGlogging because it can include unredacted headers.
References:
- What is Azure Document Intelligence in Foundry Tools?
- Document Intelligence v4.0 migration
- Azure Document Intelligence known issues and troubleshooting
- Azure DocumentIntelligence client library for Java - version 1.0.7
- Azure Document Intelligence client library for .NET - version 1.0.0
- Azure AI Document Intelligence client library for Python - version 1.0.2