Azure-docs: v2.0 and v2.1 version conflict / incompatability?

[markti]

So I've run into a problem where my batch transcription does not fire my webhook. I noticed that the batch transcription sample is using version 2.0 while this webhook documentation is referencing v2.1. When I try to create webhooks by changing the version number to 2.0, the same, working request fails. When I try to find the swagger for version 2.1 I get page not found.

https://westus.cris.ai/docs/v2.0/swagger

https://westus.cris.ai/docs/v2.1/swagger

This url is referenced by this page (https://docs.microsoft.com/en-us/azure/cognitive-services/speech-service/batch-transcription) but the swagger UI is only for version 2.0 not 2.1
https://westus.cris.ai/swagger/ui/index

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: abdefe38-e71e-4e84-d504-a47351bc1325
• Version Independent ID: acea917c-e0f6-689f-09be-97db2524a466
• Content: Webhooks - Speech Service - Azure Cognitive Services
• Content Source: articles/cognitive-services/Speech-Service/webhooks.md
• Service: cognitive-services
• Sub-service: speech-service
• GitHub Login: @PanosPeriorellis
• Microsoft Alias: panosper

[YutongTie-MSFT]

@markti
Thanks for the feedback! We are currently investigating and will update you shortly.

[YutongTie-MSFT]

@PanosPeriorellis Hi Panos, could you please help us to check for this issue? Thanks a lot.

[PanosPeriorellis]

v2.0 does not support webhooks.
v2.1 is not released and there will be breaking changes until we release the new API version.
However, if you want to look into the documentation for v2.1 (and others) please try here develop.cris.ai/swagger

[YutongTie-MSFT]

@markti
We will now proceed to close this thread. If there are further questions regarding this matter, please respond here and @YutongTie-MSFT and we will gladly continue the discussion.