From 40bb5db83ca9b92a5b8d6bf3fb4e11748cf5dcbe Mon Sep 17 00:00:00 2001
From: Denis Valeev <denis.valeev@gmail.com>
Date: Wed, 8 Oct 2025 23:35:50 -0400
Subject: [PATCH] Document Microsoft Graph SearchRequest findings

---
 docs/docs/microsoft-graph-search-request.md | 38 +++++++++++++++++++++
 docs/index.html                             |  3 +-
 2 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/microsoft-graph-search-request.md

diff --git a/docs/docs/microsoft-graph-search-request.md b/docs/docs/microsoft-graph-search-request.md
new file mode 100644
index 0000000..e339f03
--- /dev/null
+++ b/docs/docs/microsoft-graph-search-request.md
@@ -0,0 +1,38 @@
+# Microsoft Graph SearchRequest inspection
+
+This note captures the results of scanning the latest `Microsoft.Graph` NuGet package for types related to `SearchRequest`.
+
+## Version scanned
+
+- NuGet index listed version `5.94.0` as the most recent release when the package metadata was fetched.
+
+## Search term coverage
+
+| Search term | Result |
+| --- | --- |
+| `SearchRequestInner` | Not present in metadata, source, or binaries. |
+| `SearchRequestObject` | Not present in metadata, source, or binaries. |
+| `SearchRequest` | Present in the compiled assemblies and the generated XML documentation. |
+
+## Located definitions
+
+The package ships an XML documentation file describing the `Microsoft.Graph.Models.SearchRequest` model. Key members include aggregation filters, entity type selection, and serialization helpers:
+
+> ```xml
+> <member name="P:Microsoft.Graph.Models.SearchRequest.AggregationFilters">
+>   <summary>Contains one or more filters to obtain search results aggregated and filtered to a specific value of a field. Optional.</summary>
+> </member>
+> <member name="P:Microsoft.Graph.Models.SearchRequest.EntityTypes">
+>   <summary>One or more types of resources expected in the response. ... Required.</summary>
+> </member>
+> <member name="M:Microsoft.Graph.Models.SearchRequest.Serialize(Microsoft.Kiota.Abstractions.Serialization.ISerializationWriter)">
+>   <summary>Serializes information the current object</summary>
+> </member>
+> ```
+
+Request builders also expose `SearchRequest`-related operations. Two notable examples are shipped:
+
+- `Microsoft.Graph.Search.SearchRequestBuilder`, which manages the `searchEntity` singleton and supports `GetAsync`, `PatchAsync`, and query-parameter configuration helpers.
+- `Microsoft.Graph.Solutions.BackupRestore.RestorePoints.Search.SearchRequestBuilder`, which targets the backup-restore surface for restore point searches and exposes `PostAsync` plus helper configuration classes.
+
+These entries only reference the `SearchRequest` type—no `SearchRequestInner` or `SearchRequestObject` classes exist in the current package build.
diff --git a/docs/index.html b/docs/index.html
index 8eb61a4..cd581d5 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -378,7 +378,8 @@ <h2 data-doc-title>Loading…</h2>
         { id: 'external-onboarding', title: 'External content onboarding', file: 'docs/external-content-onboarding.md', summary: 'Triage outside joke decks before import' },
         { id: 'testing-automation', title: 'Testing & automation', file: 'docs/testing-and-automation.md', summary: 'Playwright suite and CI workflows' },
         { id: 'docs-maintenance', title: 'Documentation maintenance', file: 'docs/docs-maintenance.md', summary: 'Keep the knowledge base accurate and linked' },
-        { id: 'development-guide', title: 'Development guide', file: 'docs/development-guide.md', summary: 'Coding conventions and contributor tasks' }
+        { id: 'development-guide', title: 'Development guide', file: 'docs/development-guide.md', summary: 'Coding conventions and contributor tasks' },
+        { id: 'microsoft-graph-search-request', title: 'Microsoft Graph SearchRequest audit', file: 'docs/microsoft-graph-search-request.md', summary: 'Scan results for SearchRequest-related types' }
       ];
 
       const guideMap = new Map(guides.map((guide) => [guide.id, guide]));