How do I tell if we're using an API version that is being retired?

Question

We've received a notification that an Azure AI Language Language API version is being retired, and that we should transition away from it. The Required Action section of the email states:

To avoid service disruptions, please replace the Azure AI Language API version in your code to the latest version by 31 March 2025. If the feature you use in Azure AI Language is already generally available, please transition to the latest GA API version by replacing the "api-version" parameter in the API call to "api-version=2024-11-01". For preview features, replace with "api-version=2024-11-15-preview".

I'm unable to find anywhere in our code where we specify the api-version for the resource referenced in the email; as far as I can tell, we don't interact with the REST Api directly, but only make calls to it via the client library (Azure.AI.TextAnalytics, version 5.3.0).

However, the email suggests we are currently using version 2024-05-15-preview or earlier; please can you advise how I can ensure that we are definitely no longer using this version, in order to avoid any service disruption when it is retired? For example, it would be helpful if there was somewhere in the resource itself where I could see which version of the API we've been calling.

Answer 1

Hi Chris Clark,
Greetings & Welcome to Microsoft Q&A forum! Thanks for posting your query!

To determine if your application is using a retiring API version, begin by reviewing the documentation for the Azure.AI.TextAnalytics client library version 5.3.0, as it supports multiple API versions such as 3.0, 3.1, 2022-05-01, and 2023-04-01 (default). Ensure that your library is updated to the latest version, as newer releases are typically designed to work with the most recent API versions. Although you do not directly specify the api-version in your code, review your codebase to ensure there are no hardcoded API version parameters in configuration files or settings. Additionally, monitor your application's API calls to identify the version being used.
Finally, if you are still unsure about the API version being used, reach out to Azure support for assistance. They can confirm the API version being called and provide guidance on transitioning to the latest version to avoid service disruptions.

Hope this helps. Do let us know if you have any further queries.

---

If this answers your query, do click Accept Answer and Yes for was this answer helpful.