Repository navigation
Board Review: Azure AI Search - 2026-10-01 Data-plane SDK GA #10366
Description
Responsible Service Team
Azure AI Search
Main Contacts
Yangyang Lu (@yangylu91), efrainretana
Expected Code Complete Date
2026-11-04
Expected Release Date
2026-11-16
Link to Documentation Introducing/Describing the Service
https://learn.microsoft.com/azure/search/search-what-is-azure-search
Link to the Service REST APIs / TypeSpec
https://github.com/Azure/azure-rest-api-specs/tree/main/specification/search/data-plane/Search
Link to GitHub Issue for Previous Review Sessions (if applicable)
No response
Languages for this Review
.NET, Java, Python, TypeScript
.NET
- APIView: https://spa.apiview.dev/review/ce93b4e0d50e46c18296e720843a4651?activeApiRevisionId=de594cd48c8c43f193761df28e7dd519&diffApiRevisionId=61e15e8cb61f42a793d7d55f3664f74e&diffStyle=trees
- Samples: https://github.com/Azure/azure-sdk-for-net/tree/f88f842868cff6af0e04ff3a344a823ed087eaae/sdk/search/Azure.Search.Documents/samples
- PR: [Search] .NET SDK for DP 2026-10-01 GA azure-sdk-for-net#63555
- README: https://github.com/Azure/azure-sdk-for-net/blob/f88f842868cff6af0e04ff3a344a823ed087eaae/sdk/search/Azure.Search.Documents/README.md
- Changelog: https://github.com/Azure/azure-sdk-for-net/blob/f88f842868cff6af0e04ff3a344a823ed087eaae/sdk/search/Azure.Search.Documents/CHANGELOG.md
Java
Links have been refreshed to bump the version to from 12.1.0 to 12.2.0, due to a separate dependency-only release published 12.1.1 using the older 2026-04-01 service API from Azure/azure-sdk-for-java#51090.
- APIView: https://spa.apiview.dev/review/b9467d8a0d2a4b14aca565b43eb23d0e?activeApiRevisionId=75493a44041f425ea2ed30f7f3df52d5&diffApiRevisionId=77cb8ef21ae7418d9a26127e4c341e16&diffStyle=trees
- Samples: https://github.com/Azure/azure-sdk-for-java/tree/1c4c432fd310e63aed5fc055455c58fb5d4da997/sdk/search/azure-search-documents/src/samples
- PR: [Search] Java SDK for DP 2026-10-01 GA azure-sdk-for-java#50648
- README: https://github.com/Azure/azure-sdk-for-java/blob/1c4c432fd310e63aed5fc055455c58fb5d4da997/sdk/search/azure-search-documents/README.md
- Changelog: https://github.com/Azure/azure-sdk-for-java/blob/1c4c432fd310e63aed5fc055455c58fb5d4da997/sdk/search/azure-search-documents/CHANGELOG.md
Python
- APIView: https://spa.apiview.dev/review/e8d301b10edf4b29b346a87fa4905ea6?activeApiRevisionId=4e22d4addd384fd4b71ebc88be44c20e&diffApiRevisionId=f8808c00627b4003aa888764b5199b86&diffStyle=trees
- Samples: https://github.com/Azure/azure-sdk-for-python/tree/a4610424b2d91b6e5f13e78dbcc8b6fcac57ac5f/sdk/search/azure-search-documents/samples
- PR: [Search] Python SDK for DP 2026-10-01 GA azure-sdk-for-python#49365
- README: https://github.com/Azure/azure-sdk-for-python/blob/a4610424b2d91b6e5f13e78dbcc8b6fcac57ac5f/sdk/search/azure-search-documents/README.md
- Changelog: https://github.com/Azure/azure-sdk-for-python/blob/a4610424b2d91b6e5f13e78dbcc8b6fcac57ac5f/sdk/search/azure-search-documents/CHANGELOG.md
TypeScript
- APIView: https://spa.apiview.dev/review/3dec915431a84d67b026d50a58c86380?activeApiRevisionId=5e40ee05c47146db892a8033e04c9aad&diffApiRevisionId=5b0aec7786364689954458f2072f36f8&diffStyle=trees
- Samples: https://github.com/Azure/azure-sdk-for-js/tree/b3b22ca744f1a76fa828fbee9328d4dd3b5dfde5/sdk/search/search-documents/samples/v13
- PR: [Search] JS SDK for DP 2026-10-01 GA azure-sdk-for-js#40171
- README: https://github.com/Azure/azure-sdk-for-js/blob/b3b22ca744f1a76fa828fbee9328d4dd3b5dfde5/sdk/search/search-documents/README.md
- Changelog: https://github.com/Azure/azure-sdk-for-js/blob/b3b22ca744f1a76fa828fbee9328d4dd3b5dfde5/sdk/search/search-documents/CHANGELOG.md
Cross-Language Context
(No dedicated textbox for such context on this form, so we put it here.)
Merged spec PRs
- GA API: Azure Search Data-Plane 2026-10-01 GA Release azure-rest-api-specs#46315
- Follow-up SDK customizations: [Search] 2026-10-01 DP SDK Customizations azure-rest-api-specs#47423
Request SSE GA review
- SSE support uses the new emitter and TypeSpec implementation.
- Review streaming API shape, cross-language consistency, cancellation, error handling, and cleanup.
GA spec correction since 2026-04-01
TypeSpec fix PR: Azure/azure-rest-api-specs#47112
- Missing version gating accidentally exposed preview-only elements in the
2026-04-01GA contract. The fix removes those elements from that GA contract; per the PR, unsupported scenarios already returned HTTP 400, with no backend behavior changes. - Related public SDK APIs are removed in this release. Since some shipped in stable SDKs, we need guidance on approving the removals versus retaining compatibility APIs, and on package versioning.
Go
No response
Additional Languages (C++, Rust)
No response
Confirmations
- For existing packages, a diff revision is selected in APIView for each language. For brand-new packages, the initial API surface is submitted.
- CI checks are passing on all linked PRs
Activity
github-actions commentedon Oct 21, 2026
✅ All materials verified for .NET, Java, Python, TypeScript.
This review request is ready for architects. The
ready-for-reviewlabel has been applied.Assigned for review: .NET → Jesse Squire (@jsquire), m-nash, JoshLove-msft · Java → Jonathan Giles (@JonathanGiles), Alan Zimmer (@alzimmermsft) · Python → Jeff Fisher (@xirzec), Kashif Khan (@kashifkhan) · TypeScript → Jeff Fisher (@xirzec), Maor Leger (@maorleger)
Assigned architects are explicitly mentioned and receive GitHub assignment notifications. Apply your
<language>-api-approvedlabel when the review is complete.Validation details
.NET:
Java:
Python:
TypeScript:
maorleger commentedon Oct 22, 2026
Left a few comments in the JS PR 👍 cc efrainretana - feel free to reach out if you want to chat
alzimmermsft commentedon Oct 23, 2026
Left comments on the Java ApiView, its showing breaking changes, is that expected or did something odd happen there with it?
yangylu91 commentedon Oct 29, 2026
Hi Alan Zimmer (@alzimmermsft) , I addressed most of the comments. Could you pls take another look? Thank you!
yangylu91 commentedon Oct 29, 2026
Hi Maor Leger (@maorleger) , I've addressed your comments with new commits. Could you pls take another look? Thanks!
yangylu91 commentedon Oct 29, 2026
Hi Jesse Squire (@jsquire) / m-nash / JoshLove-msft, could you pls help review the .net SDK request? Thank you!
yangylu91 commentedon Oct 29, 2026
Hi Jeff Fisher (@xirzec) / Kashif Khan (@kashifkhan), could you pls help review the Python SDK request? Thank you!
kashifkhan commentedon Nov 2, 2026
Yangyang Lu (@yangylu91) left a comment, seems like there are breaking changes in here?
yangylu91 commentedon Nov 3, 2026
Cross-Language Context
Merged spec PRs
Request SSE GA review
GA spec correction since 2026-04-01
TypeSpec fix PR: Azure/azure-rest-api-specs#47112
2026-04-01GA contract. The fix removes those elements from that GA contract; per the PR, unsupported scenarios already returned HTTP 400, with no backend behavior changes.yangylu91 commentedon Nov 3, 2026
Kashif Khan (@kashifkhan) Yes, it's due to a GA spec fix: Azure/azure-rest-api-specs#47112. I replied to your comment in APIview. Could you pls take another look? Thanks for your time and help!
yangylu91 commentedon Nov 6, 2026
Status summary (11/6/2026 11am PT)