From 278e23d9680d20944cb453ea283ff696b5234507 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 29 Jul 2026 18:16:38 +0000
Subject: [PATCH 1/2] Initial plan


From 005e4568c4a6ad1dab8d7c3141fc584cb0648f03 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 29 Jul 2026 18:58:43 +0000
Subject: [PATCH 2/2] [Search 2026-08-01-preview] Add 2026-08-01-preview
 ApiVersion; document codegen blocker

Co-authored-by: efrainretana <141282336+efrainretana@users.noreply.github.com>
---
 sdk/search/azure-search-documents/CHANGELOG.md    | 12 ++++++++++++
 sdk/search/azure-search-documents/_metadata.json  |  4 ++--
 .../azure/search/documents/_patch.py              |  1 +
 .../tests/test_search_client.py                   | 15 ++++++++++++++-
 .../azure-search-documents/tsp-location.yaml      |  2 +-
 5 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/sdk/search/azure-search-documents/CHANGELOG.md b/sdk/search/azure-search-documents/CHANGELOG.md
index ddec13dd33b2..eb5312b6b686 100644
--- a/sdk/search/azure-search-documents/CHANGELOG.md
+++ b/sdk/search/azure-search-documents/CHANGELOG.md
@@ -4,12 +4,24 @@
 
 ### Features Added
 
+- Added `ApiVersion.V2026_08_01_PREVIEW` so the `2026-08-01-preview` Search API version can be
+  selected via the `api_version` keyword on the clients.
+
 ### Breaking Changes
 
 ### Bugs Fixed
 
 ### Other Changes
 
+- Updated `tsp-location.yaml` and `_metadata.json` to target spec commit
+  `c19e358860e3cb89a8c7021e8c5a181ab6ef7f62` (`2026-08-01-preview`). The new `2026-08-01-preview`
+  models and operations are not yet included in this release: the documented generator emits the
+  synthesized root-namespace request/response models (e.g. `EntraAppAuthentication`,
+  `FileUploadMetadata`, `KnowledgeBaseRetrieveDefaults`) into a top-level `search` package and
+  references them with an invalid cross-package relative import (`from ......search import models`),
+  which is non-importable. This is a spec-side defect (the root `Search` namespace lacks a blanket
+  `@@clientNamespace("Azure.Search.Documents")` in `client.tsp`) and must be fixed in
+  `Azure/azure-rest-api-specs` before the full surface can be regenerated.
 ## 12.1.0b1 (2026-05-28)
 
 ### Features Added
diff --git a/sdk/search/azure-search-documents/_metadata.json b/sdk/search/azure-search-documents/_metadata.json
index b41f4dc8e881..cd58dfc162d6 100644
--- a/sdk/search/azure-search-documents/_metadata.json
+++ b/sdk/search/azure-search-documents/_metadata.json
@@ -1,6 +1,6 @@
 {
-  "apiVersion": "2026-05-01-preview",
+  "apiVersion": "2026-08-01-preview",
   "apiVersions": {
-    "Search": "2026-05-01-preview"
+    "Search": "2026-08-01-preview"
   }
 }
\ No newline at end of file
diff --git a/sdk/search/azure-search-documents/azure/search/documents/_patch.py b/sdk/search/azure-search-documents/azure/search/documents/_patch.py
index 9fbd081e9f8e..8a866c742759 100644
--- a/sdk/search/azure-search-documents/azure/search/documents/_patch.py
+++ b/sdk/search/azure-search-documents/azure/search/documents/_patch.py
@@ -42,6 +42,7 @@ class ApiVersion(str, Enum, metaclass=CaseInsensitiveEnumMeta):
     V2025_09_01 = "2025-09-01"
     V2026_04_01 = "2026-04-01"
     V2026_05_01_PREVIEW = "2026-05-01-preview"
+    V2026_08_01_PREVIEW = "2026-08-01-preview"
 
 
 DEFAULT_VERSION = ApiVersion.V2026_05_01_PREVIEW
diff --git a/sdk/search/azure-search-documents/tests/test_search_client.py b/sdk/search/azure-search-documents/tests/test_search_client.py
index b42360d19ad0..d06de5be633a 100644
--- a/sdk/search/azure-search-documents/tests/test_search_client.py
+++ b/sdk/search/azure-search-documents/tests/test_search_client.py
@@ -12,7 +12,12 @@
 from azure.core.credentials import AzureKeyCredential
 from azure.core.paging import ItemPaged
 
-from azure.search.documents import ApiVersion, IndexDocumentsBatch, RequestEntityTooLargeError, SearchClient
+from azure.search.documents import (
+    ApiVersion,
+    IndexDocumentsBatch,
+    RequestEntityTooLargeError,
+    SearchClient,
+)
 from azure.search.documents._operations._patch import SearchPageIterator
 from azure.search.documents.models import FacetResult, IndexingResult, SearchResult
 
@@ -93,6 +98,14 @@ def test_constructor_accepts_supported_api_version_enum(self):
 
         assert client._config.api_version == ApiVersion.V2020_06_30
 
+    def test_api_version_enum_includes_2026_08_01_preview(self):
+        assert ApiVersion.V2026_08_01_PREVIEW == "2026-08-01-preview"
+
+    def test_constructor_accepts_2026_08_01_preview_api_version_enum(self):
+        client = create_search_client(api_version=ApiVersion.V2026_08_01_PREVIEW)
+
+        assert client._config.api_version == "2026-08-01-preview"
+
 
 class TestSearchRequestBuilding:
     @mock.patch("azure.search.documents._operations._operations._SearchClientOperationsMixin._search_post")
diff --git a/sdk/search/azure-search-documents/tsp-location.yaml b/sdk/search/azure-search-documents/tsp-location.yaml
index 0d61dee0e1df..01f8e3d0c4c0 100644
--- a/sdk/search/azure-search-documents/tsp-location.yaml
+++ b/sdk/search/azure-search-documents/tsp-location.yaml
@@ -1,4 +1,4 @@
 directory: specification/search/data-plane/Search
-commit: 8be8c75d9bb11ea95d8a7e251db74aa78b5cd76c
+commit: c19e358860e3cb89a8c7021e8c5a181ab6ef7f62
 repo: Azure/azure-rest-api-specs