Share via

Question about sudden deprecation behavior of Image Analysis API

Manh Nguyen 0 Reputation points
2025-04-17T03:10:22.49+00:00

Hi Microsoft team,

Starting from April 12th, I encountered an issue when calling the Image Analysis API with version 2023-02-01-preview. The API returned a 410 Gone error, indicating that the version was deprecated. However, after a few hours, the same request started working again without any changes. This behavior has repeated on subsequent days.

I have since switched to version 2024-02-01, and everything is working as expected.

I would like to ask:

Is Microsoft in the process of retiring or phasing out older preview versions like 2023-02-01-preview?

Is there an official timeline or retirement schedule for older Image Analysis API versions?

  • In the future, how can I proactively stay informed about such deprecations or version changes to avoid unexpected service disruptions?
  • Is there any plan to drop my latest version (2024-02-01)? I want to be warned before the problem happens.

Additional Info:

The endpoint I used:

{my_service}.cognitiveservices.azure.com/computervision/imageanalysis:analyze?api-version=2023-02-01-preview&features=read

Looking forward to your guidance so I can plan version upgrades and prevent future downtime. Thanks in advance!

Computer Vision
Computer Vision
An Azure artificial intelligence service that analyzes content in images and video.
0 comments

2 answers

Sort by: Most helpful
Most helpful Newest Oldest
  1. Pranav Singh 0 Reputation points
    2025-04-17T06:16:52.27+00:00

    Seems 2023-02-01-preview is already expired & 2023-02-01-preview is oldest in preview as per https://learn.microsoft.com/en-us/azure/ai-services/openai/api-version-deprecation?source=recommendations#updating-api-versions

    enter image description here

    Also Microsoft on same documentation mentioned to upgrade to new API version to make sure there is no impact to your application.

    I will also recommend to upgrade to latest GA mentioned here https://learn.microsoft.com/en-us/azure/ai-services/openai/reference instead of preview release so that you application works

    0 comments
  2. SriLakshmi C 6,255 Reputation points Microsoft External Staff Moderator
    2025-04-17T13:13:01.8533333+00:00

    Hello @Manh Nguyen,

    Microsoft does periodically retire older preview versions of the Azure Image Analysis API as part of its API lifecycle management. For example, preview versions of Azure AI Vision 3.0 and 3.1 were scheduled for retirement on September 30, 2023, and Image Analysis 4.0 Preview APIs are set to retire by March 31, 2025. It’s likely that version 2023-02-01-preview is undergoing a phased deprecation process, which could explain the intermittent 410 Gone errors you experienced. While temporary reactivation can occur during these transitions, it’s strongly recommended not to rely on deprecated preview versions, as they may be disabled without consistent behavior.

    To avoid such unexpected disruptions, we recommend monitoring the Azure Updates page and subscribing to Azure Service Health Alerts for notifications specific to your region or resources. Additionally, keeping track of Release notes and changelogs for API versions will help ensure you’re aligned with supported and stable versions.

    Regarding version 2024-02-01, it is currently the latest available and fully supported. There are no announced plans for its deprecation at this time, but continued monitoring of Azure documentation is advisable to stay informed about future changes.

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

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

    Thank you!

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.