From 53627869b5fed4549f6d4230595135c53ec065d8 Mon Sep 17 00:00:00 2001
From: Dylan Stetts <131203492+dylanstetts@users.noreply.github.com>
Date: Mon, 23 Mar 2026 17:42:03 -0400
Subject: [PATCH 1/2] Update search-concept-person.md with emailAddress note

Added note about emailAddress property availability.
---
 concepts/search-concept-person.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/concepts/search-concept-person.md b/concepts/search-concept-person.md
index ba9e484c334..5f644555e70 100644
--- a/concepts/search-concept-person.md
+++ b/concepts/search-concept-person.md
@@ -45,6 +45,9 @@ The people API returns the following set of properties.
 | surname                  | String  |
 | userPrincipalName        | String  |
 
+> [!NOTE]
+> The emailAddress property is only returned with the beta `/search` endpoint as of now.
+
 ## Person types
 The following table shows people types and subtypes supported in the people API.
 

From 4bd4b342d5822222e9069b44b387d89929822712 Mon Sep 17 00:00:00 2001
From: Dylan Stetts <131203492+dylanstetts@users.noreply.github.com>
Date: Mon, 30 Mar 2026 11:37:13 -0400
Subject: [PATCH 2/2] Mark properties for beta `/search` endpoint

Updated the properties table to indicate which properties are only returned with the beta `/search` endpoint.
---
 concepts/search-concept-person.md | 40 +++++++++++++++----------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/concepts/search-concept-person.md b/concepts/search-concept-person.md
index 5f644555e70..7c5c95c43df 100644
--- a/concepts/search-concept-person.md
+++ b/concepts/search-concept-person.md
@@ -26,27 +26,27 @@ You can use the following APIs to search for people inside an organization.
 ## Returned people properties
 The people API returns the following set of properties.
 
-| Property                 | Type    |
-|:-------------------------|:--------|
-| additionalOfficeLocation | String  |
-| companyName              | String  |
-| department               | String  |
-| displayName              | String  |
-| emailAddress             | String  |
-| givenName                | String  |
-| hitId                    | String  |
-| imAddress                | String  |
-| jobTitle                 | String  |
-| officeLocation           | String  |
-| personType               | String  |
-| phones                   | String  |
-| rank                     | Integer |
-| summary                  | String  |
-| surname                  | String  |
-| userPrincipalName        | String  |
-
 > [!NOTE]
-> The emailAddress property is only returned with the beta `/search` endpoint as of now.
+> Properties maked with an asterisk (*) are only returned with the beta `/search` endpoint as of now.
+
+| Property                  | Type    |
+|:--------------------------|:--------|
+| additionalOfficeLocation* | String  |
+| companyName               | String  |
+| department                | String  |
+| displayName               | String  |
+| emailAddress*             | String  |
+| givenName                 | String  |
+| hitId                     | String  |
+| imAddress                 | String  |
+| jobTitle                  | String  |
+| officeLocation            | String  |
+| personType                | String  |
+| phones                    | String  |
+| rank                      | Integer |
+| summary                   | String  |
+| surname                   | String  |
+| userPrincipalName         | String  |
 
 ## Person types
 The following table shows people types and subtypes supported in the people API.