diff --git a/clean_v10_metadata/cleanMetadata.xml b/clean_v10_metadata/cleanMetadata.xml
index 2d5f93f31..2de4b8779 100644
--- a/clean_v10_metadata/cleanMetadata.xml
+++ b/clean_v10_metadata/cleanMetadata.xml
@@ -3401,14 +3401,14 @@
             </Collection>
           </Annotation>
         </NavigationProperty>
-        <NavigationProperty Name="acceptedSenders" Type="Collection(graph.directoryObject)" ContainsTarget="true" />
+        <NavigationProperty Name="acceptedSenders" Type="Collection(graph.directoryObject)" />
         <NavigationProperty Name="calendar" Type="graph.calendar" ContainsTarget="true" />
         <NavigationProperty Name="calendarView" Type="Collection(graph.event)" ContainsTarget="true" />
         <NavigationProperty Name="conversations" Type="Collection(graph.conversation)" ContainsTarget="true" />
         <NavigationProperty Name="events" Type="Collection(graph.event)" ContainsTarget="true" />
         <NavigationProperty Name="photo" Type="graph.profilePhoto" ContainsTarget="true" />
         <NavigationProperty Name="photos" Type="Collection(graph.profilePhoto)" ContainsTarget="true" />
-        <NavigationProperty Name="rejectedSenders" Type="Collection(graph.directoryObject)" ContainsTarget="true" />
+        <NavigationProperty Name="rejectedSenders" Type="Collection(graph.directoryObject)" />
         <NavigationProperty Name="threads" Type="Collection(graph.conversationThread)" ContainsTarget="true" />
         <NavigationProperty Name="drive" Type="graph.drive" ContainsTarget="true" />
         <NavigationProperty Name="drives" Type="Collection(graph.drive)" ContainsTarget="true" />
@@ -11412,8 +11412,8 @@
       </Action>
       <Action Name="accept" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
         <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
+        <Parameter Name="SendResponse" Type="Edm.Boolean" />
       </Action>
       <Action Name="cancel" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
@@ -11421,9 +11421,8 @@
       </Action>
       <Action Name="decline" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="ProposedNewTime" Type="graph.timeSlot" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
         <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
+        <Parameter Name="SendResponse" Type="Edm.Boolean" />
       </Action>
       <Action Name="decline" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.scheduleChangeRequest" />
@@ -11454,9 +11453,8 @@
       </Action>
       <Action Name="tentativelyAccept" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="ProposedNewTime" Type="graph.timeSlot" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
         <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
+        <Parameter Name="SendResponse" Type="Edm.Boolean" />
       </Action>
       <Action Name="copy" IsBound="true" EntitySetPath="bindingParameter">
         <Parameter Name="bindingParameter" Type="graph.mailFolder" />
@@ -19521,21 +19519,6 @@
       </Annotations>
       <Annotations Target="microsoft.graph.todo/lists" />
       <Annotations Target="microsoft.graph.todoTaskList/tasks" />
-      <Action Name="accept" IsBound="true">
-        <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
-      </Action>
-      <Action Name="decline" IsBound="true">
-        <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
-      </Action>
-      <Action Name="tentativelyAccept" IsBound="true">
-        <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
-      </Action>
     </Schema>
     <Schema Namespace="microsoft.graph.callRecords" xmlns="http://docs.oasis-open.org/odata/ns/edm">
       <EnumType Name="callType">
diff --git a/clean_v10_metadata/cleanMetadataWithDescriptionsv1.0.xml b/clean_v10_metadata/cleanMetadataWithDescriptionsv1.0.xml
index 399342742..40f9cfc1e 100644
--- a/clean_v10_metadata/cleanMetadataWithDescriptionsv1.0.xml
+++ b/clean_v10_metadata/cleanMetadataWithDescriptionsv1.0.xml
@@ -1910,7 +1910,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the date and time the activity was performed. The Timestamp type is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
         </Property>
         <Property Name="activityDisplayName" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the activity name or the operation name (examples: 'Create User' and 'Add member to group'). For full list, see Azure AD activity list." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the activity name or the operation name (E.g. 'Create User', 'Add member to group'). For a list of activities logged, refer to Azure Ad activity list." />
         </Property>
         <Property Name="additionalDetails" Type="Collection(graph.keyValue)">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates additional details on the activity." />
@@ -1932,7 +1932,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the result of the activity. Possible values are: success, failure, timeout, unknownFutureValue." />
         </Property>
         <Property Name="resultReason" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Describes cause of 'failure' or 'timeout' results." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the reason for failure if the result is 'Failure' or 'timeout'." />
         </Property>
         <Property Name="targetResources" Type="Collection(graph.targetResource)">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates information on which resource was changed due to the activity. Target Resource Type can be User, Device, Directory, App, Role, Group, Policy or Other." />
@@ -1940,71 +1940,73 @@
       </EntityType>
       <EntityType Name="signIn" BaseType="graph.entity">
         <Property Name="appDisplayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="App name displayed in the Azure Portal." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The application name displayed in the Azure Portal." />
         </Property>
         <Property Name="appId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Unique GUID representing the app ID in the Azure Active Directory." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The application identifier in Azure Active Directory." />
+        </Property>
+        <Property Name="appliedConditionalAccessPolicies" Type="Collection(graph.appliedConditionalAccessPolicy)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list of conditional access policies that are triggered by the corresponding sign-in activity." />
         </Property>
-        <Property Name="appliedConditionalAccessPolicies" Type="Collection(graph.appliedConditionalAccessPolicy)" />
         <Property Name="clientAppUsed" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Identifies the legacy client used for sign-in activity.  Includes Browser, Exchange Active Sync, modern clients, IMAP, MAPI, SMTP, and POP." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The legacy client used for sign-in activity. For example, Browser, Exchange Active Sync,Modern clients, IMAP, MAPI, SMTP, or POP." />
         </Property>
         <Property Name="conditionalAccessStatus" Type="graph.conditionalAccessStatus">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Reports status of an activated conditional access policy. Possible values are: success, failure, notApplied, and unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The status of the conditional access policy triggered. Possible values: success, failure, notApplied, or unknownFutureValue." />
         </Property>
         <Property Name="correlationId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The request ID sent from the client when the sign-in is initiated; used to troubleshoot sign-in activity." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The identifier that's sent from the client when sign-in is initiated. This is used for troubleshooting the corresponding sign-in activity when calling for support." />
         </Property>
         <Property Name="createdDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Date and time (UTC) the sign-in was initiated. Example: midnight on Jan 1, 2014 is reported as '2014-01-01T00:00:00Z'." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The date and time the sign-in was initiated. The Timestamp type is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'." />
         </Property>
         <Property Name="deviceDetail" Type="graph.deviceDetail">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Device information from where the sign-in occurred; includes device ID, operating system, and browser." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The device information from where the sign-in occurred. Includes information such as deviceId, OS, and browser." />
         </Property>
         <Property Name="ipAddress" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="IP address of the client used to sign in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The IP address of the client from where the sign-in occurred." />
         </Property>
         <Property Name="isInteractive" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates if a sign-in is interactive or not." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether a sign-in is interactive or not." />
         </Property>
         <Property Name="location" Type="graph.signInLocation">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Provides the city, state, and country code where the sign-in originated." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The city, state, and 2 letter country code from where the sign-in occurred." />
         </Property>
         <Property Name="resourceDisplayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the resource the user signed into." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name of the resource that the user signed in to." />
         </Property>
         <Property Name="resourceId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="ID of the resource that the user signed into." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The identifier of the resource that the user signed in to." />
         </Property>
         <Property Name="riskDetail" Type="graph.riskDetail">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Provides the 'reason' behind a specific state of a risky user, sign-in or a risk event. The possible values are: none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, unknownFutureValue. The value none means that no action has been performed on the user or sign-in so far. Note: Details for this property require an Azure AD Premium P2 license. Other licenses return the value hidden." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The reason behind a specific state of a risky user, sign-in, or a risk event. Possible values: none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, or unknownFutureValue. The value none means that no action has been performed on the user or sign-in so far. Note: Details for this property are only available for Azure AD Premium P2 customers. All other customers are returned hidden." />
         </Property>
         <Property Name="riskEventTypes" Type="Collection(graph.riskEventType)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Risk event types associated with the sign-in. The possible values are: unlikelyTravel, anonymizedIPAddress, maliciousIPAddress, unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddress, leakedCredentials, investigationsThreatIntelligence,  generic, and unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The list of risk event types associated with the sign-in. Possible values: unlikelyTravel, anonymizedIPAddress, maliciousIPAddress, unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddress, leakedCredentials, investigationsThreatIntelligence,  generic, or unknownFutureValue." />
         </Property>
         <Property Name="riskEventTypes_v2" Type="Collection(Edm.String)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The list of risk event types associated with the sign-in. Possible values: unlikelyTravel, anonymizedIPAddress, maliciousIPAddress, unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddress, leakedCredentials, investigationsThreatIntelligence,  generic, or unknownFutureValue." />
         </Property>
         <Property Name="riskLevelAggregated" Type="graph.riskLevel">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Aggregated risk level. The possible values are: none, low, medium, high, hidden, and unknownFutureValue. The value hidden means the user or sign-in was not enabled for Azure AD Identity Protection. Note: Details for this property are only available for Azure AD Premium P2 customers. All other customers will be returned hidden." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The aggregated risk level. Possible values: none, low, medium, high, hidden, or unknownFutureValue. The value hidden means the user or sign-in was not enabled for Azure AD Identity Protection. Note: Details for this property are only available for Azure AD Premium P2 customers. All other customers are returned hidden." />
         </Property>
         <Property Name="riskLevelDuringSignIn" Type="graph.riskLevel">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Risk level during sign-in. The possible values are: none, low, medium, high, hidden, and unknownFutureValue. The value hidden means the user or sign-in was not enabled for Azure AD Identity Protection. Note: Details for this property are only available for Azure AD Premium P2 customers. All other customers will be returned hidden." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The risk level during sign-in. Possible values: none, low, medium, high, hidden, or unknownFutureValue. The value hidden means the user or sign-in was not enabled for Azure AD Identity Protection. Note: Details for this property are only available for Azure AD Premium P2 customers. All other customers are returned hidden." />
         </Property>
         <Property Name="riskState" Type="graph.riskState">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Reports status of the risky user, sign-in, or a risk event. The possible values are: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The risk state of a risky user, sign-in, or a risk event. Possible values: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, or unknownFutureValue." />
         </Property>
         <Property Name="status" Type="graph.signInStatus">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Sign-in status. Includes the error code and description of the error (in case of a sign-in failure)." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The sign-in status. Includes the error code and description of the error (in case of a sign-in failure)." />
         </Property>
         <Property Name="userDisplayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Display name of the user that initiated the sign-in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the user." />
         </Property>
         <Property Name="userId" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="ID of the user that initiated the sign-in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The identifier of the user." />
         </Property>
         <Property Name="userPrincipalName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="User principal name of the user that initiated the sign-in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The UPN of the user." />
         </Property>
       </EntityType>
       <EntityType Name="restrictedSignIn" BaseType="graph.signIn">
@@ -2015,19 +2017,19 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the user being invited." />
         </Property>
         <Property Name="invitedUserEmailAddress" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The email address of the user being invited. Required. The following special characters are not permitted in the email address:Tilde (~)Exclamation point (!)Number sign (#)Dollar sign ($)Percent (%)Circumflex (^)Ampersand (&amp;)Asterisk (*)Parentheses (( ))Plus sign (+)Equal sign (=)Brackets ([ ])Braces ({ })Backslash (/)Slash mark (/)Pipe (/|)Semicolon (;)Colon (:)Quotation marks (')Angle brackets (&lt; &gt;)Question mark (?)Comma (,)However, the following exceptions apply:A period (.) or a hyphen (-) is permitted anywhere in the user name, except at the beginning or end of the name.An underscore (_) is permitted anywhere in the user name. This includes at the beginning or end of the name." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The email address of the user being invited. Required. The following special characters are not permitted in the email address:Tilde (~)Exclamation point (!)At sign (@)Number sign (#)Dollar sign ($)Percent (%)Circumflex (^)Ampersand (&amp;)Asterisk (*)Parentheses (( ))Hyphen (-)Plus sign (+)Equal sign (=)Brackets ([ ])Braces ({ })Backslash (/)Slash mark (/)Pipe (`" />
         </Property>
         <Property Name="invitedUserMessageInfo" Type="graph.invitedUserMessageInfo">
           <Annotation Term="Org.OData.Core.V1.Description" String="Additional configuration for the message being sent to the invited user, including customizing message text, language and cc recipient list." />
         </Property>
         <Property Name="invitedUserType" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The userType of the user being invited. By default, this is Guest. You can invite as Member if you are a company administrator." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The userType of the user being invited. By default, this is Guest. You can invite as Member if you're are company administrator." />
         </Property>
         <Property Name="inviteRedeemUrl" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The URL the user can use to redeem their invitation. Read-only" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The URL the user can use to redeem their invitation. Read-only." />
         </Property>
         <Property Name="inviteRedirectUrl" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The URL the user should be redirected to once the invitation is redeemed. Required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The URL user should be redirected to once the invitation is redeemed. Required." />
         </Property>
         <Property Name="sendInvitationMessage" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether an email should be sent to the user being invited or not. The default is false." />
@@ -2044,43 +2046,43 @@
       </EntityType>
       <EntityType Name="user" BaseType="graph.directoryObject" OpenType="true">
         <Property Name="accountEnabled" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="true if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="true if the account is enabled; otherwise, false. This property is required when a user is created. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="ageGroup" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Sets the age group of the user. Allowed values: null, minor, notAdult and adult. Refer to the legal age group property definitions for further information." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Sets the age group of the user. Allowed values: null, minor, notAdult and adult. Refer to the legal age group property definitions for further information. Returned only on $select." />
         </Property>
         <Property Name="assignedLicenses" Type="Collection(graph.assignedLicense)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The licenses that are assigned to the user. Not nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The licenses that are assigned to the user. Returned only on $select. Not nullable." />
         </Property>
         <Property Name="assignedPlans" Type="Collection(graph.assignedPlan)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The plans that are assigned to the user. Read-only. Not nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The plans that are assigned to the user. Returned only on $select. Read-only. Not nullable." />
         </Property>
         <Property Name="businessPhones" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The telephone numbers for the user. NOTE: Although this is a string collection, only one number can be set for this property. Read-only for users synced from on-premises directory. Returned by default." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The telephone numbers for the user. Only one number can be set for this property. Returned by default. Read-only for users synced from on-premises directory." />
         </Property>
         <Property Name="city" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The city in which the user is located. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The city in which the user is located. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="companyName" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The company name which the user is associated. This property can be useful for describing the company that an external user comes from. The maximum length of the company name is 64 chararcters.Returned only on $select." />
         </Property>
         <Property Name="consentProvidedForMinor" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Sets whether consent has been obtained for minors. Allowed values: null, granted, denied and notRequired. Refer to the legal age group property definitions for further information." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Sets whether consent has been obtained for minors. Allowed values: null, granted, denied and notRequired. Refer to the legal age group property definitions for further information. Returned only on $select." />
         </Property>
         <Property Name="country" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The country/region in which the user is located; for example, 'US' or 'UK'. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The country/region in which the user is located; for example, 'US' or 'UK'. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="createdDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The created date of the user object." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The date and time the user was created. The value cannot be modified and is automatically populated when the entity is created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. Property is nullable. A null value indicates that an accurate creation time couldn't be determined for the user. Returned only on $select. Read-only. Supports $filter." />
         </Property>
         <Property Name="creationType" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the user account was created as a regular school or work account (null), an external account (Invitation), a local account for an Azure Active Directory B2C tenant (LocalAccount) or self-service sign-up using email verification (EmailVerified). Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the user account was created as a regular school or work account (null), an external account (Invitation), a local account for an Azure Active Directory B2C tenant (LocalAccount) or self-service sign-up using email verification (EmailVerified). Returned only on $select. Read-only." />
         </Property>
         <Property Name="department" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The name for the department in which the user works. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name for the department in which the user works. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="displayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Returned by default. Supports $filter and $orderby." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name displayed in the address book for the user. This value is usually the combination of the user's first name, middle initial, and last name. This property is required when a user is created and it cannot be cleared during updates. Returned by default. Supports $filter and $orderby." />
         </Property>
         <Property Name="employeeHireDate" Type="Edm.DateTimeOffset">
           <Annotation Term="Org.OData.Core.V1.Description" String="The date and time when the user was hired or will start work in case of a future hire. Returned only on $select. Supports $filter." />
@@ -2101,13 +2103,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Shows the timestamp for the latest change to the externalUserState property. Returned only on $select." />
         </Property>
         <Property Name="faxNumber" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The fax number of the user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The fax number of the user. Returned only on $select." />
         </Property>
         <Property Name="givenName" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The given name (first name) of the user. Returned by default. Supports $filter." />
         </Property>
         <Property Name="identities" Type="Collection(graph.objectIdentity)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the identities that can be used to sign in to this user account. An identity can be provided by Microsoft (also known as a local account), by organizations, or by social identity providers such as Facebook, Google, and Microsoft, and tied to a user account. May contain multiple items with the same signInType value. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the identities that can be used to sign in to this user account. An identity can be provided by Microsoft (also known as a local account), by organizations, or by social identity providers such as Facebook, Google, and Microsoft, and tied to a user account. May contain multiple items with the same signInType value. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="imAddresses" Type="Collection(Edm.String)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The instant message voice over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only." />
@@ -2119,136 +2121,136 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The user's job title. Returned by default. Supports $filter." />
         </Property>
         <Property Name="lastPasswordChangeDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The time when this Azure AD user last changed their password. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The time when this Azure AD user last changed their password. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Returned only on $select." />
         </Property>
         <Property Name="legalAgeGroupClassification" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Allowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. Refer to the legal age group property definitions for further information." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Allowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. Refer to the legal age group property definitions for further information. Returned only on $select." />
         </Property>
         <Property Name="licenseAssignmentStates" Type="Collection(graph.licenseAssignmentState)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="State of license assignments for this user. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="State of license assignments for this user. Returned only on $select. Read-only." />
         </Property>
         <Property Name="mail" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The SMTP address for the user, for example, 'jeff@contoso.onmicrosoft.com'. Returned by default. Supports $filter and endsWith." />
         </Property>
         <Property Name="mailNickname" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The mail alias for the user. This property must be specified when a user is created. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The mail alias for the user. This property must be specified when a user is created. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="mobilePhone" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The primary cellular telephone number for the user. Read-only for users synced from on-premises directory. Returned by default." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The primary cellular telephone number for the user. Returned by default. Read-only for users synced from on-premises directory." />
         </Property>
         <Property Name="officeLocation" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The office location in the user's place of business. Returned by default." />
         </Property>
         <Property Name="onPremisesDistinguishedName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises Active Directory distinguished name or DN. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises Active Directory distinguished name or DN. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Returned only on $select. Read-only." />
         </Property>
         <Property Name="onPremisesDomainName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Returned only on $select. Read-only." />
         </Property>
         <Property Name="onPremisesExtensionAttributes" Type="graph.onPremisesExtensionAttributes">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Contains extensionAttributes 1-15 for the user. Note that the individual extension attributes are neither selectable nor filterable. For an onPremisesSyncEnabled user, the source of authority for this set of properties is the on-premises and is read-only. For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update. These extension attributes are also known as Exchange custom attributes 1-15." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains extensionAttributes 1-15 for the user. Note that the individual extension attributes are neither selectable nor filterable. For an onPremisesSyncEnabled user, the source of authority for this set of properties is the on-premises and is read-only and is read-only. For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update. These extension attributes are also known as Exchange custom attributes 1-15. Returned only on $select." />
         </Property>
         <Property Name="onPremisesImmutableId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="This property is used to associate an on-premises Active Directory user account to their Azure AD user object. This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user's userPrincipalName (UPN) property. Important: The $ and _ characters cannot be used when specifying this property. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="This property is used to associate an on-premises Active Directory user account to their Azure AD user object. This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user's userPrincipalName (UPN) property. Important: The $ and _ characters cannot be used when specifying this property. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="onPremisesLastSyncDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the last time at which the object was synced with the on-premises directory; for example: '2013-02-16T03:04:54Z'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the last time at which the object was synced with the on-premises directory; for example: '2013-02-16T03:04:54Z'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned only on $select. Read-only." />
         </Property>
         <Property Name="onPremisesProvisioningErrors" Type="Collection(graph.onPremisesProvisioningError)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Errors when using Microsoft synchronization product during provisioning." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Errors when using Microsoft synchronization product during provisioning. Returned only on $select." />
         </Property>
         <Property Name="onPremisesSamAccountName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises samAccountName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises sAMAccountName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Returned only on $select. Read-only." />
         </Property>
         <Property Name="onPremisesSecurityIdentifier" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Returned only on $select. Read-only." />
         </Property>
         <Property Name="onPremisesSyncEnabled" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Read-only" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Returned only on $select. Read-only." />
         </Property>
         <Property Name="onPremisesUserPrincipalName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises userPrincipalName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises userPrincipalName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Returned only on $select. Read-only." />
         </Property>
         <Property Name="otherMails" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A list of additional email addresses for the user; for example: ['bob@contoso.com', 'Robert@fabrikam.com']. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list of additional email addresses for the user; for example: ['bob@contoso.com', 'Robert@fabrikam.com'].Returned only on $select.  Supports$filter." />
         </Property>
         <Property Name="passwordPolicies" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies password policies for the user. This value is an enumeration with one possible value being 'DisableStrongPassword', which allows weaker passwords than the default policy to be specified. 'DisablePasswordExpiration' can also be specified. The two may be specified together; for example: 'DisablePasswordExpiration, DisableStrongPassword'." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies password policies for the user. This value is an enumeration with one possible value being 'DisableStrongPassword', which allows weaker passwords than the default policy to be specified. 'DisablePasswordExpiration' can also be specified. The two may be specified together; for example: 'DisablePasswordExpiration, DisableStrongPassword'.Returned only on $select." />
         </Property>
         <Property Name="passwordProfile" Type="graph.passwordProfile">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the password profile for the user. The profile contains the user's password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required. Returned only on $select." />
         </Property>
         <Property Name="postalCode" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code. Returned only on $select." />
         </Property>
         <Property Name="preferredLanguage" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The preferred language for the user. Should follow ISO 639-1 Code; for example 'en-US'. Returned by default." />
         </Property>
         <Property Name="provisionedPlans" Type="Collection(graph.provisionedPlan)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The plans that are provisioned for the user. Read-only. Not nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The plans that are provisioned for the user. Returned only on $select. Read-only. Not nullable." />
         </Property>
         <Property Name="proxyAddresses" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="For example: ['SMTP: bob@contoso.com', 'smtp: bob@sales.contoso.com'] The any operator is required for filter expressions on multi-valued properties. Read-only, Not nullable. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="For example: ['SMTP: bob@contoso.com', 'smtp: bob@sales.contoso.com'] The any operator is required for filter expressions on multi-valued properties. Returned only on $select. Read-only, Not nullable. Supports $filter." />
         </Property>
         <Property Name="showInAddressList" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="true if the Outlook global address list should contain this user, otherwise false. If not set, this will be treated as true. For users invited through the invitation manager, this property will be set to false." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="true if the Outlook global address list should contain this user, otherwise false. If not set, this will be treated as true. For users invited through the invitation manager, this property will be set to false. Returned only on $select." />
         </Property>
         <Property Name="signInSessionsValidFromDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications will get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph).  If this happens, the application will need to acquire a new refresh token by making a request to the authorize endpoint. Read-only. Use revokeSignInSessions to reset." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications will get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph).  If this happens, the application will need to acquire a new refresh token by making a request to the authorize endpoint. Returned only on $select. Read-only. Use revokeSignInSessions to reset." />
         </Property>
         <Property Name="state" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The state or province in the user's address. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The state or province in the user's address. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="streetAddress" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The street address of the user's place of business." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The street address of the user's place of business. Returned only on $select." />
         </Property>
         <Property Name="surname" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The user's surname (family name or last name). Returned by default. Supports $filter." />
         </Property>
         <Property Name="usageLocation" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries.  Examples include: 'US', 'JP', and 'GB'. Not nullable. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries.  Examples include: 'US', 'JP', and 'GB'. Not nullable. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="userPrincipalName" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant's collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Returned by default. Supports $filter, $orderby, and endsWith." />
         </Property>
         <Property Name="userType" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A string value that can be used to classify user types in your directory, such as 'Member' and 'Guest'. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A string value that can be used to classify user types in your directory, such as 'Member' and 'Guest'. Returned only on $select. Supports $filter." />
         </Property>
         <Property Name="mailboxSettings" Type="graph.mailboxSettings">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale and time zone." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select." />
         </Property>
         <Property Name="deviceEnrollmentLimit" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The limit on the maximum number of devices that the user is permitted to enroll. Allowed values are 5 or 1000." />
         </Property>
         <Property Name="aboutMe" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A freeform text entry field for the user to describe themselves." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A freeform text entry field for the user to describe themselves. Returned only on $select." />
         </Property>
         <Property Name="birthday" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Returned only on $select." />
         </Property>
         <Property Name="hireDate" Type="Edm.DateTimeOffset" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned only on $select.  Note: This property is specific to SharePoint Online. We recommend using the native employeeHireDate property to set and update hire date values using Microsoft Graph APIs." />
         </Property>
         <Property Name="interests" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to describe their interests." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to describe their interests. Returned only on $select." />
         </Property>
         <Property Name="mySite" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The URL for the user's personal site." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The URL for the user's personal site. Returned only on $select." />
         </Property>
         <Property Name="pastProjects" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate their past projects." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate their past projects. Returned only on $select." />
         </Property>
         <Property Name="preferredName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The preferred name for the user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The preferred name for the user. Returned only on $select." />
         </Property>
         <Property Name="responsibilities" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate their responsibilities." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate their responsibilities. Returned only on $select." />
         </Property>
         <Property Name="schools" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate the schools they have attended." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate the schools they have attended. Returned only on $select." />
         </Property>
         <Property Name="skills" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate their skills." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A list for the user to enumerate their skills. Returned only on $select." />
         </Property>
         <NavigationProperty Name="appRoleAssignments" Type="Collection(graph.appRoleAssignment)" ContainsTarget="true" />
         <NavigationProperty Name="createdObjects" Type="Collection(graph.directoryObject)">
@@ -2285,7 +2287,7 @@
               <String>microsoft.graph.orgContact</String>
             </Collection>
           </Annotation>
-          <Annotation Term="Org.OData.Core.V1.Description" String="The groups and directory roles that the user is a member of. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The groups, directory roles and administrative units that the user is a member of. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="oauth2PermissionGrants" Type="Collection(graph.oAuth2PermissionGrant)" />
         <NavigationProperty Name="ownedDevices" Type="Collection(graph.directoryObject)">
@@ -2318,7 +2320,9 @@
           </Annotation>
           <Annotation Term="Org.OData.Core.V1.Description" String="Devices that are registered for the user. Read-only. Nullable." />
         </NavigationProperty>
-        <NavigationProperty Name="scopedRoleMemberOf" Type="Collection(graph.scopedRoleMembership)" ContainsTarget="true" />
+        <NavigationProperty Name="scopedRoleMemberOf" Type="Collection(graph.scopedRoleMembership)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The scoped-role administrative unit memberships for this user. Read-only. Nullable." />
+        </NavigationProperty>
         <NavigationProperty Name="transitiveMemberOf" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
             <Collection>
@@ -2350,7 +2354,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The user's contacts. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="events" Type="Collection(graph.event)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The user's events. Default is to show events under the Default Calendar. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="inferenceClassification" Type="graph.inferenceClassification" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Relevance classification of the user's messages based on explicit designations which override inferred relevance or importance." />
@@ -2362,15 +2366,17 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The messages in a mailbox or folder. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="outlook" Type="graph.outlookUser" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Selective Outlook services available to the user. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="people" Type="Collection(graph.person)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="People that are relevant to the user. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. The most relevant people to the user. The collection is ordered by their relevance to the user, which is determined by the user's communication, collaboration and business relationships. A person is an aggregation of information from across mail, contacts and social networks." />
         </NavigationProperty>
         <NavigationProperty Name="photo" Type="graph.profilePhoto" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The user's profile photo. Read-only." />
         </NavigationProperty>
-        <NavigationProperty Name="photos" Type="Collection(graph.profilePhoto)" ContainsTarget="true" />
+        <NavigationProperty Name="photos" Type="Collection(graph.profilePhoto)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable." />
+        </NavigationProperty>
         <NavigationProperty Name="drive" Type="graph.drive" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The user's OneDrive. Read-only." />
         </NavigationProperty>
@@ -2379,7 +2385,7 @@
         </NavigationProperty>
         <NavigationProperty Name="followedSites" Type="Collection(graph.site)" />
         <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the user. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the user. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="managedDevices" Type="Collection(graph.managedDevice)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The managed devices associated with the user." />
@@ -2391,12 +2397,14 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The list of troubleshooting events for this user." />
         </NavigationProperty>
         <NavigationProperty Name="planner" Type="graph.plannerUser" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Entry-point to the Planner resource that might exist for a user. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Selective Planner services available to the user. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="insights" Type="graph.officeGraphInsights" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable." />
         </NavigationProperty>
-        <NavigationProperty Name="settings" Type="graph.userSettings" ContainsTarget="true" />
+        <NavigationProperty Name="settings" Type="graph.userSettings" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable." />
+        </NavigationProperty>
         <NavigationProperty Name="onenote" Type="graph.onenote" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Read-only." />
         </NavigationProperty>
@@ -2405,8 +2413,12 @@
         </NavigationProperty>
         <NavigationProperty Name="onlineMeetings" Type="Collection(graph.onlineMeeting)" ContainsTarget="true" />
         <NavigationProperty Name="presence" Type="graph.presence" ContainsTarget="true" />
-        <NavigationProperty Name="joinedTeams" Type="Collection(graph.team)" ContainsTarget="true" />
-        <NavigationProperty Name="teamwork" Type="graph.userTeamwork" ContainsTarget="true" />
+        <NavigationProperty Name="joinedTeams" Type="Collection(graph.team)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Microsoft Teams teams that the user is a member of. Read-only. Nullable." />
+        </NavigationProperty>
+        <NavigationProperty Name="teamwork" Type="graph.userTeamwork" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="A container for Microsoft Teams features available for the user. Read-only. Nullable." />
+        </NavigationProperty>
         <NavigationProperty Name="todo" Type="graph.todo" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the To Do services available to a user." />
         </NavigationProperty>
@@ -2476,13 +2488,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represent the online meeting service providers that can be used to create online meetings in this calendar. Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness." />
         </Property>
         <Property Name="canEdit" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="True if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="True if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access, through an Outlook client or the corresponding calendarPermission resource. Read-only." />
         </Property>
         <Property Name="canShare" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="True if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="True if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it. Read-only." />
         </Property>
         <Property Name="canViewPrivateItems" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="True if the user can read calendar items that have been marked private, false otherwise." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="True if the user can read calendar items that have been marked private, false otherwise. This property is set through an Outlook client or the corresponding calendarPermission resource. Read-only." />
         </Property>
         <Property Name="changeKey" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only." />
@@ -2494,7 +2506,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The default online meeting provider for meetings sent from this calendar. Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness." />
         </Property>
         <Property Name="hexColor" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The calendar color, expressed in a hex color code of three hexidecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The calendar color, expressed in a hex color code of three hexidecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is  empty." />
         </Property>
         <Property Name="isDefaultCalendar" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="True if this is the default calendar where new events are created by default, false otherwise." />
@@ -2509,7 +2521,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The calendar name." />
         </Property>
         <Property Name="owner" Type="graph.emailAddress">
-          <Annotation Term="Org.OData.Core.V1.Description" String="If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user. Read-only." />
         </Property>
         <NavigationProperty Name="calendarPermissions" Type="Collection(graph.calendarPermission)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The permissions of the users with whom the calendar is shared." />
@@ -2665,16 +2677,16 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL cannot be accessed from within an iFrame." />
         </Property>
         <NavigationProperty Name="attachments" Type="Collection(graph.attachment)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Navigation property. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="calendar" Type="graph.calendar" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The calendar that contains the event. Navigation property. Read-only." />
         </NavigationProperty>
         <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the event. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the event. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="instances" Type="Collection(graph.event)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The instances of the event. Navigation property. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions that have been modified, but does not include occurrences that have been cancelled from the series. Navigation property. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="multiValueExtendedProperties" Type="Collection(graph.multiValueLegacyExtendedProperty)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of multi-value extended properties defined for the event. Read-only. Nullable." />
@@ -2804,7 +2816,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The phonetic Japanese surname (last name)  of the contact." />
         </Property>
         <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the contact. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the contact. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="multiValueExtendedProperties" Type="Collection(graph.multiValueLegacyExtendedProperty)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of multi-value extended properties defined for the contact. Read-only. Nullable." />
@@ -2861,7 +2873,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The body of the message. It can be in HTML or text format. Find out about safe HTML in a message body." />
         </Property>
         <Property Name="bodyPreview" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The first 255 characters of the message body. It is in text format." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The first 255 characters of the message body. It is in text format. If the message contains instances of mention, this property would contain a concatenation of these mentions as well." />
         </Property>
         <Property Name="ccRecipients" Type="Collection(graph.recipient)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The Cc: recipients for the message." />
@@ -2982,7 +2994,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Free-form notes that the user has taken about this person." />
         </Property>
         <Property Name="personType" Type="graph.personType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The type of person." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of person, for example distribution list." />
         </Property>
         <Property Name="phones" Type="Collection(graph.phone)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The person's phone numbers." />
@@ -3127,85 +3139,85 @@
       <EntityType Name="extension" BaseType="graph.entity" Abstract="true" OpenType="true" />
       <EntityType Name="managedDevice" BaseType="graph.entity">
         <Property Name="activationLockBypassCode" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Code that allows the Activation Lock on a device to be bypassed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Code that allows the Activation Lock on a device to be bypassed. This property is read-only." />
         </Property>
         <Property Name="androidSecurityPatchLevel" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Android security patch level" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Android security patch level. This property is read-only." />
         </Property>
         <Property Name="azureADDeviceId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier for the Azure Active Directory device. Read only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier for the Azure Active Directory device. Read only. This property is read-only." />
         </Property>
         <Property Name="azureADRegistered" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Whether the device is Azure Active Directory registered." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Whether the device is Azure Active Directory registered. This property is read-only." />
         </Property>
         <Property Name="complianceGracePeriodExpirationDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The DateTime when device compliance grace period expires" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The DateTime when device compliance grace period expires. This property is read-only." />
         </Property>
         <Property Name="complianceState" Type="graph.complianceState" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Compliance state of the device. Possible values are: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Compliance state of the device. This property is read-only. Possible values are: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager." />
         </Property>
         <Property Name="configurationManagerClientEnabledFeatures" Type="graph.configurationManagerClientEnabledFeatures">
-          <Annotation Term="Org.OData.Core.V1.Description" String="ConfigrMgr client enabled features" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="ConfigrMgr client enabled features. This property is read-only." />
         </Property>
         <Property Name="deviceActionResults" Type="Collection(graph.deviceActionResult)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="List of ComplexType deviceActionResult objects." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="List of ComplexType deviceActionResult objects. This property is read-only." />
         </Property>
         <Property Name="deviceCategoryDisplayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Device category display name" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Device category display name. This property is read-only." />
         </Property>
         <Property Name="deviceEnrollmentType" Type="graph.deviceEnrollmentType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Enrollment type of the device. Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Enrollment type of the device. This property is read-only. Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, appleUserEnrollment, appleUserEnrollmentWithServiceAccount, azureAdJoinUsingAzureVmExtension, androidEnterpriseDedicatedDevice, androidEnterpriseFullyManaged, androidEnterpriseCorporateWorkProfile." />
         </Property>
         <Property Name="deviceHealthAttestationState" Type="graph.deviceHealthAttestationState">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The device health attestation state." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The device health attestation state. This property is read-only." />
         </Property>
         <Property Name="deviceName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the device" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the device. This property is read-only." />
         </Property>
         <Property Name="deviceRegistrationState" Type="graph.deviceRegistrationState" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Device registration state. Possible values are: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Device registration state. This property is read-only. Possible values are: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown." />
         </Property>
         <Property Name="easActivated" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Whether the device is Exchange ActiveSync activated." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Whether the device is Exchange ActiveSync activated. This property is read-only." />
         </Property>
         <Property Name="easActivationDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Exchange ActivationSync activation time of the device." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Exchange ActivationSync activation time of the device. This property is read-only." />
         </Property>
         <Property Name="easDeviceId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Exchange ActiveSync Id of the device." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Exchange ActiveSync Id of the device. This property is read-only." />
         </Property>
         <Property Name="emailAddress" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Email(s) for the user associated with the device" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Email(s) for the user associated with the device. This property is read-only." />
         </Property>
         <Property Name="enrolledDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Enrollment time of the device." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Enrollment time of the device. This property is read-only." />
         </Property>
         <Property Name="exchangeAccessState" Type="graph.deviceManagementExchangeAccessState" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The Access State of the device in Exchange. Possible values are: none, unknown, allowed, blocked, quarantined." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Access State of the device in Exchange. This property is read-only. Possible values are: none, unknown, allowed, blocked, quarantined." />
         </Property>
         <Property Name="exchangeAccessStateReason" Type="graph.deviceManagementExchangeAccessStateReason" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The reason for the device's access state in Exchange. Possible values are: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The reason for the device's access state in Exchange. This property is read-only. Possible values are: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp." />
         </Property>
         <Property Name="exchangeLastSuccessfulSyncDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Last time the device contacted Exchange." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Last time the device contacted Exchange. This property is read-only." />
         </Property>
         <Property Name="freeStorageSpaceInBytes" Type="Edm.Int64" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Free Storage in Bytes" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Free Storage in Bytes. This property is read-only." />
         </Property>
         <Property Name="imei" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="IMEI" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="IMEI. This property is read-only." />
         </Property>
         <Property Name="isEncrypted" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Device encryption status" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Device encryption status. This property is read-only." />
         </Property>
         <Property Name="isSupervised" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Device supervised status" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Device supervised status. This property is read-only." />
         </Property>
         <Property Name="jailBroken" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="whether the device is jail broken or rooted." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="whether the device is jail broken or rooted. This property is read-only." />
         </Property>
         <Property Name="lastSyncDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The date and time that the device last completed a successful sync with Intune." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The date and time that the device last completed a successful sync with Intune. This property is read-only." />
         </Property>
         <Property Name="managedDeviceName" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Automatically generated name to identify a device. Can be overwritten to a user friendly name." />
@@ -3214,55 +3226,55 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Ownership of the device. Can be 'company' or 'personal'. Possible values are: unknown, company, personal." />
         </Property>
         <Property Name="managementAgent" Type="graph.managementAgentType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Management channel of the device. Intune, EAS, etc. Possible values are: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Management channel of the device. Intune, EAS, etc. This property is read-only. Possible values are: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController, microsoft365ManagedMdm." />
         </Property>
         <Property Name="manufacturer" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Manufacturer of the device" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Manufacturer of the device. This property is read-only." />
         </Property>
         <Property Name="meid" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="MEID" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="MEID. This property is read-only." />
         </Property>
         <Property Name="model" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Model of the device" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Model of the device. This property is read-only." />
         </Property>
         <Property Name="operatingSystem" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Operating system of the device. Windows, iOS, etc." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Operating system of the device. Windows, iOS, etc. This property is read-only." />
         </Property>
         <Property Name="osVersion" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Operating system version of the device." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Operating system version of the device. This property is read-only." />
         </Property>
         <Property Name="partnerReportedThreatState" Type="graph.managedDevicePartnerReportedHealthState" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. Possible values are: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Possible values are: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured." />
         </Property>
         <Property Name="phoneNumber" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Phone number of the device" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Phone number of the device. This property is read-only." />
         </Property>
         <Property Name="remoteAssistanceSessionErrorDetails" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="An error string that identifies issues when creating Remote Assistance session objects." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="An error string that identifies issues when creating Remote Assistance session objects. This property is read-only." />
         </Property>
         <Property Name="remoteAssistanceSessionUrl" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Url that allows a Remote Assistance session to be established with the device." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Url that allows a Remote Assistance session to be established with the device. This property is read-only." />
         </Property>
         <Property Name="serialNumber" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="SerialNumber" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="SerialNumber. This property is read-only." />
         </Property>
         <Property Name="subscriberCarrier" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Subscriber Carrier" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Subscriber Carrier. This property is read-only." />
         </Property>
         <Property Name="totalStorageSpaceInBytes" Type="Edm.Int64" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Total Storage in Bytes" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Total Storage in Bytes. This property is read-only." />
         </Property>
         <Property Name="userDisplayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="User display name" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="User display name. This property is read-only." />
         </Property>
         <Property Name="userId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Unique Identifier for the user associated with the device" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Unique Identifier for the user associated with the device. This property is read-only." />
         </Property>
         <Property Name="userPrincipalName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Device user principal name" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Device user principal name. This property is read-only." />
         </Property>
         <Property Name="wiFiMacAddress" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Wi-Fi MAC" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Wi-Fi MAC. This property is read-only." />
         </Property>
         <NavigationProperty Name="deviceCompliancePolicyStates" Type="Collection(graph.deviceCompliancePolicyState)" ContainsTarget="true" />
         <NavigationProperty Name="deviceConfigurationStates" Type="Collection(graph.deviceConfigurationState)" ContainsTarget="true" />
@@ -3330,24 +3342,30 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable. Returns the plannerTasks assigned to the user." />
         </NavigationProperty>
         <NavigationProperty Name="tasks" Type="Collection(graph.plannerTask)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable. Returns the plannerPlans shared with the user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable. Returns the plannerTasks assigned to the user." />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="officeGraphInsights" BaseType="graph.entity">
         <NavigationProperty Name="shared" Type="Collection(graph.sharedInsight)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Calculated relationship identifying documents shared with or by the user. This includes URLs, file attachments, and reference attachments to OneDrive for Business and SharePoint files found in Outlook messages and meetings. This also includes URLs and reference attachments to Teams conversations. Ordered by recency of share." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Access this property from the derived type itemInsights." />
         </NavigationProperty>
         <NavigationProperty Name="trending" Type="Collection(graph.trending)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Calculated relationship identifying documents trending around a user. Trending documents are calculated based on activity of the user's closest network of people and include files stored in OneDrive for Business and SharePoint. Trending insights help the user to discover potentially useful content that the user has access to, but has never viewed before." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Access this property from the derived type itemInsights." />
         </NavigationProperty>
         <NavigationProperty Name="used" Type="Collection(graph.usedInsight)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Calculated relationship identifying the latest documents viewed or modified by a user, including OneDrive for Business and SharePoint documents, ranked by recency of use." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Access this property from the derived type itemInsights." />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="userSettings" BaseType="graph.entity">
-        <Property Name="contributionToContentDiscoveryAsOrganizationDisabled" Type="Edm.Boolean" Nullable="false" />
-        <Property Name="contributionToContentDiscoveryDisabled" Type="Edm.Boolean" Nullable="false" />
-        <NavigationProperty Name="shiftPreferences" Type="graph.shiftPreferences" ContainsTarget="true" />
+        <Property Name="contributionToContentDiscoveryAsOrganizationDisabled" Type="Edm.Boolean" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Reflects the organization level setting controlling delegate access to the trending API. When set to true, the organization doesn't have access to Office Delve. The relevancy of the content displayed in Microsoft 365, for example in Suggested sites in SharePoint Home and the Discover view in OneDrive for Business is affected for the whole organization. This setting is read-only and can only be changed by administrators in the SharePoint admin center." />
+        </Property>
+        <Property Name="contributionToContentDiscoveryDisabled" Type="Edm.Boolean" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="When set to true, the delegate access to the user's trending API is disabled. When set to true, documents in the user's Office Delve are disabled. When set to true, the relevancy of the content displayed in Microsoft 365, for example in Suggested sites in SharePoint Home and the Discover view in OneDrive for Business is affected. Users can control this setting in Office Delve." />
+        </Property>
+        <NavigationProperty Name="shiftPreferences" Type="graph.shiftPreferences" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The shift preferences for the user." />
+        </NavigationProperty>
       </EntityType>
       <EntityType Name="onenote" BaseType="graph.entity">
         <NavigationProperty Name="notebooks" Type="Collection(graph.notebook)" ContainsTarget="true">
@@ -3415,7 +3433,7 @@
       </EntityType>
       <EntityType Name="onlineMeeting" BaseType="graph.entity" OpenType="true">
         <Property Name="allowedPresenters" Type="graph.onlineMeetingPresenters">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies who can be a presenter in a meeting. Possible values are listed in the following table." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies who can be a presenter in a meeting. Possible values are everyone, organization, roleIsPresenter, organizer, and unknownFutureValue." />
         </Property>
         <Property Name="audioConferencing" Type="graph.audioConferencing">
           <Annotation Term="Org.OData.Core.V1.Description" String="The phone access (dial-in) information for an online meeting. Read-only." />
@@ -3429,18 +3447,20 @@
         <Property Name="endDateTime" Type="Edm.DateTimeOffset">
           <Annotation Term="Org.OData.Core.V1.Description" String="The meeting end time in UTC." />
         </Property>
-        <Property Name="externalId" Type="Edm.String" />
+        <Property Name="externalId" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The external ID. A custom ID. Optional." />
+        </Property>
         <Property Name="isEntryExitAnnounced" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Whether or not to announce when callers join or leave." />
         </Property>
         <Property Name="joinInformation" Type="graph.itemBody">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The join information in the language and locale variant specified in the Accept-Language request HTTP header. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only" />
         </Property>
         <Property Name="joinWebUrl" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The join URL of the online meeting. Read-only." />
         </Property>
         <Property Name="lobbyBypassSettings" Type="graph.lobbyBypassSettings">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies which participants can bypass the meeting   lobby." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies which participants can bypass the meeting lobby." />
         </Property>
         <Property Name="participants" Type="graph.meetingParticipants">
           <Annotation Term="Org.OData.Core.V1.Description" String="The participants associated with the online meeting.  This includes the organizer and the attendees." />
@@ -3457,7 +3477,7 @@
       </EntityType>
       <EntityType Name="presence" BaseType="graph.entity">
         <Property Name="activity" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The supplemental information to a user's availability. Possible values are Available, Away, BeRightBack, Busy, DoNotDisturb, InACall, InAConferenceCall, Inactive, InAMeeting, Offline, OffWork, OutOfOffice, PresenceUnknown, Presenting, UrgentInterruptionsOnly." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The supplemental information to a user's availability. Possible values are Available, Away, BeRightBack, Busy, DoNotDisturb, InACall, InAConferenceCall, Inactive,InAMeeting, Offline, OffWork,OutOfOffice, PresenceUnknown,Presenting, UrgentInterruptionsOnly." />
         </Property>
         <Property Name="availability" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The base presence information for a user. Possible values are Available, AvailableIdle,  Away, BeRightBack, Busy, BusyIdle, DoNotDisturb, Offline, PresenceUnknown" />
@@ -3541,7 +3561,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies settings for an application that implements a web API." />
         </Property>
         <Property Name="appId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier for the application that is assigned to an application by Azure AD. Not nullable. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier for the application that is assigned by Azure AD. Not nullable. Read-only." />
         </Property>
         <Property Name="applicationTemplateId" Type="Edm.String" />
         <Property Name="appRoles" Type="Collection(graph.appRole)" Nullable="false">
@@ -3555,17 +3575,17 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The display name for the application." />
         </Property>
         <Property Name="groupMembershipClaims" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Configures the groups claim issued in a user or OAuth 2.0 access token that the application expects. To set this attribute, use one of the following valid string values:NoneSecurityGroup: For security groups and Azure AD rolesAll: This gets all of the security groups, distribution groups, and Azure AD directory roles that the signed-in user is a member of." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Configures the groups claim issued in a user or OAuth 2.0 access token that the application expects. To set this attribute, use one of the following string values:NoneSecurityGroup: For security groups and Azure AD rolesAll: This gets all of the security groups, distribution groups, and Azure AD directory roles that the signed-in user is a member of." />
         </Property>
         <Property Name="identifierUris" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The URIs that identify the application within its Azure AD tenant, or within a verified custom domain if the application is multi-tenant. For more information see Application Objects and Service Principal Objects. The any operator is required for filter expressions on multi-valued properties. Not nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The URIs that identify the application within its Azure AD tenant, or within a verified custom domain if the application is multi-tenant. For more information, see Application Objects and Service Principal Objects. The any operator is required for filter expressions on multi-valued properties. Not nullable." />
         </Property>
         <Property Name="info" Type="graph.informationalUrl">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Basic profile information of the application such as  app's marketing, support, terms of service and privacy statement URLs. The terms of service and privacy statement are surfaced to users through the user consent experience. For more info, see How to: Add Terms of service and privacy statement for registered Azure AD apps." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Basic profile information of the application, such as it's marketing, support, terms of service, and privacy statement URLs. The terms of service and privacy statement are surfaced to users through the user consent experience. For more information, see How to: Add Terms of service and privacy statement for registered Azure AD apps." />
         </Property>
         <Property Name="isDeviceOnlyAuthSupported" Type="Edm.Boolean" />
         <Property Name="isFallbackPublicClient" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the fallback application type as public client, such as an installed application running on a mobile device. The default value is false which means the fallback application type is confidential client such as a web app. There are certain scenarios where Azure AD cannot determine the client application type. For example, the ROPC flow where it is configured without specifying a redirect URI. In those cases Azure AD interprets the application type based on the value of this property." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the fallback application type as public client, such as an installed application running on a mobile device. The default value is false which means the fallback application type is confidential client such as a web app. There are certain scenarios where Azure AD cannot determine the client application type. For example, the ROPC flow where the application is configured without specifying a redirect URI. In those cases Azure AD interprets the application type based on the value of this property." />
         </Property>
         <Property Name="keyCredentials" Type="Collection(graph.keyCredential)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of key credentials associated with the application. Not nullable." />
@@ -3588,15 +3608,17 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies settings for installed clients such as desktop or mobile devices." />
         </Property>
         <Property Name="publisherDomain" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The verified publisher domain for the application. Read-only. For more information, see How to: Configure an application's publisher domain." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The verified publisher domain for the application. Read-only." />
         </Property>
         <Property Name="requiredResourceAccess" Type="Collection(graph.requiredResourceAccess)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the resources that the application needs to access. This property also specifies the set of OAuth permission scopes and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. Not nullable." />
         </Property>
         <Property Name="signInAudience" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the Microsoft accounts that are supported for the current application. Supported values are:AzureADMyOrg: Users with a Microsoft work or school account in my organization’s Azure AD tenant (single tenant)AzureADMultipleOrgs: Users with a Microsoft work or school account in any organization’s Azure AD tenant (multi-tenant).AzureADandPersonalMicrosoftAccount: Users with a personal Microsoft account, or a work or school account in any organization’s Azure AD tenant.PersonalMicrosoftAccount: Users with a personal Microsoft account only.For authenticating users with Azure AD B2C user flows, use AzureADandPersonalMicrosoftAccount. This value allows for the widest set of user identities including local accounts and user identities from Microsoft, Facebook, Google, Twitter, or any OpenID Connect provider." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the Microsoft accounts that are supported for the current application. Supported values are:AzureADMyOrg: Users with a Microsoft work or school account in my organization’s Azure AD tenant (single-tenant).AzureADMultipleOrgs: Users with a Microsoft work or school account in any organization’s Azure AD tenant (multi-tenant).AzureADandPersonalMicrosoftAccount: Users with a personal Microsoft account, or a work or school account in any organization’s Azure AD tenant.PersonalMicrosoftAccount: Users with a personal Microsoft account only." />
+        </Property>
+        <Property Name="spa" Type="graph.spaApplication">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens." />
         </Property>
-        <Property Name="spa" Type="graph.spaApplication" />
         <Property Name="tags" Type="Collection(Edm.String)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Custom strings that can be used to categorize and identify the application. Not nullable." />
         </Property>
@@ -3625,7 +3647,9 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Directory objects that are owners of the application. The owners are a set of non-admin users who are allowed to modify this object. Requires version 2013-11-08 or newer. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="tokenIssuancePolicies" Type="Collection(graph.tokenIssuancePolicy)" />
-        <NavigationProperty Name="tokenLifetimePolicies" Type="Collection(graph.tokenLifetimePolicy)" />
+        <NavigationProperty Name="tokenLifetimePolicies" Type="Collection(graph.tokenLifetimePolicy)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The tokenLifetimePolicies assigned to this application." />
+        </NavigationProperty>
       </EntityType>
       <EntityType Name="extensionProperty" BaseType="graph.directoryObject" OpenType="true">
         <Property Name="appDisplayName" Type="Edm.String">
@@ -3725,7 +3749,9 @@
         <Property Name="preferredSingleSignOnMode" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the single sign-on mode configured for this application. Azure AD uses the preferred single sign-on mode to launch the application from Microsoft 365 or the Azure AD My Apps. The supported values are password, saml, external, and oidc." />
         </Property>
-        <Property Name="preferredTokenSigningKeyThumbprint" Type="Edm.String" />
+        <Property Name="preferredTokenSigningKeyThumbprint" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Reserved for internal use only. Do not write or otherwise rely on this property. May be removed in future versions." />
+        </Property>
         <Property Name="replyUrls" Type="Collection(Edm.String)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The URLs that user tokens are sent to for sign in with the associated application, or the redirect URIs that OAuth 2.0 authorization codes and access tokens are sent to for the associated application. Not nullable." />
         </Property>
@@ -3738,7 +3764,9 @@
         <Property Name="servicePrincipalType" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Identifies if the service principal represents an application or a managed identity. This is set by Azure AD internally. For a service principal that represents an application this is set as Application. For a service principal that represent a managed identity this is set as ManagedIdentity." />
         </Property>
-        <Property Name="signInAudience" Type="Edm.String" />
+        <Property Name="signInAudience" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies what Microsoft accounts are supported for the associated application. Read-only." />
+        </Property>
         <Property Name="tags" Type="Collection(Edm.String)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Custom strings that can be used to categorize and identify the service principal. Not nullable." />
         </Property>
@@ -3762,8 +3790,12 @@
           </Annotation>
           <Annotation Term="Org.OData.Core.V1.Description" String="Directory objects created by this service principal. Read-only. Nullable." />
         </NavigationProperty>
-        <NavigationProperty Name="delegatedPermissionClassifications" Type="Collection(graph.delegatedPermissionClassification)" ContainsTarget="true" />
-        <NavigationProperty Name="endpoints" Type="Collection(graph.endpoint)" ContainsTarget="true" />
+        <NavigationProperty Name="delegatedPermissionClassifications" Type="Collection(graph.delegatedPermissionClassification)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The permission classifications for delegated permissions exposed by the app that this service principal represents." />
+        </NavigationProperty>
+        <NavigationProperty Name="endpoints" Type="Collection(graph.endpoint)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Endpoints available for discovery. Services like Sharepoint populate this property with a tenant specific SharePoint endpoints that other applications can discover and use in their experiences." />
+        </NavigationProperty>
         <NavigationProperty Name="homeRealmDiscoveryPolicies" Type="Collection(graph.homeRealmDiscoveryPolicy)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The homeRealmDiscoveryPolicies assigned to this service principal." />
         </NavigationProperty>
@@ -3831,18 +3863,28 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The classification value being given. Possible value: low. Does not support $filter." />
         </Property>
         <Property Name="permissionId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier (id) for the delegated permission listed in the oauth2PermissionScopes collection of the servicePrincipal. Required on create. Does not support $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier (id) for the delegated permission listed in the publishedPermissionScopes collection of the servicePrincipal. Required on create. Does not support $filter." />
         </Property>
         <Property Name="permissionName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The claim value (value) for the delegated permission listed in the oauth2PermissionScopes collection of the servicePrincipal. Does not support $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The claim value (value) for the delegated permission listed in the publishedPermissionScopes collection of the servicePrincipal. Does not support $filter." />
         </Property>
       </EntityType>
       <EntityType Name="endpoint" BaseType="graph.directoryObject" OpenType="true">
-        <Property Name="capability" Type="Edm.String" Nullable="false" />
-        <Property Name="providerId" Type="Edm.String" />
-        <Property Name="providerName" Type="Edm.String" />
-        <Property Name="providerResourceId" Type="Edm.String" />
-        <Property Name="uri" Type="Edm.String" Nullable="false" />
+        <Property Name="capability" Type="Edm.String" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Describes the capability that is associated with this resource. (e.g. Messages, Conversations, etc.)  Not nullable. Read-only." />
+        </Property>
+        <Property Name="providerId" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Application id of the publishing underlying service. Not nullable. Read-only." />
+        </Property>
+        <Property Name="providerName" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the publishing underlying service. Read-only." />
+        </Property>
+        <Property Name="providerResourceId" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="For Microsoft 365 groups, this is set to a well-known name for the resource (e.g. Yammer.FeedURL etc.). Not nullable. Read-only." />
+        </Property>
+        <Property Name="uri" Type="Edm.String" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="URL of the published resource. Not nullable. Read-only." />
+        </Property>
       </EntityType>
       <EntityType Name="identityContainer" BaseType="graph.entity">
         <NavigationProperty Name="conditionalAccess" Type="graph.conditionalAccessRoot" ContainsTarget="true" />
@@ -3852,10 +3894,18 @@
         <NavigationProperty Name="policies" Type="Collection(graph.conditionalAccessPolicy)" ContainsTarget="true" />
       </EntityType>
       <EntityType Name="identityProvider" BaseType="graph.entity">
-        <Property Name="clientId" Type="Edm.String" />
-        <Property Name="clientSecret" Type="Edm.String" />
-        <Property Name="name" Type="Edm.String" />
-        <Property Name="type" Type="Edm.String" />
+        <Property Name="clientId" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The client ID for the application obtained when registering the application with the identity provider. This is a required field." />
+        </Property>
+        <Property Name="clientSecret" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The client secret for the application obtained when registering the application with the identity provider. This is write-only. A read operation will return '****'. This is a required field." />
+        </Property>
+        <Property Name="name" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the identity provider." />
+        </Property>
+        <Property Name="type" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The identity provider type is a required field.For B2B scenario:GoogleFacebookFor B2C scenario:MicrosoftGoogleAmazonLinkedInFacebookGitHubTwitterWeiboQQWeChatOpenIDConnect" />
+        </Property>
       </EntityType>
       <EntityType Name="activityBasedTimeoutPolicy" BaseType="graph.stsPolicy" />
       <EntityType Name="administrativeUnit" BaseType="graph.directoryObject" OpenType="true">
@@ -3866,7 +3916,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Display name for the administrative unit." />
         </Property>
         <Property Name="visibility" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Controls whether the administrative unit and its members are hidden or public. Can be set to HiddenMembership or Public. If not set, default behavior is Public. When set to HiddenMembership, only members of the administrative unit can list other members of the adminstrative unit." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls whether the adminstrative unit and its members are hidden or public. Can be set to HiddenMembership or Public. If not set, default behavior is Public. When set to HiddenMembership, only members of the administrative unit can list other members of the adminstrative unit." />
         </Property>
         <NavigationProperty Name="members" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
@@ -3884,7 +3934,9 @@
         <NavigationProperty Name="scopedRoleMembers" Type="Collection(graph.scopedRoleMembership)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Scoped-role members of this Administrative Unit.  HTTP Methods: GET (list scopedRoleMemberships), POST (add scopedRoleMembership), DELETE (remove scopedRoleMembership)." />
         </NavigationProperty>
-        <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true" />
+        <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for this Administrative Unit. Nullable." />
+        </NavigationProperty>
       </EntityType>
       <EntityType Name="authorizationPolicy" BaseType="graph.policyBase">
         <Property Name="allowedToSignUpEmailBasedSubscriptions" Type="Edm.Boolean" Nullable="false">
@@ -3927,7 +3979,7 @@
       </EntityType>
       <EntityType Name="device" BaseType="graph.directoryObject" OpenType="true">
         <Property Name="accountEnabled" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="true if the account is enabled; otherwise, false. Required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="true if the account is enabled; otherwise, false. default is true." />
         </Property>
         <Property Name="alternativeSecurityIds" Type="Collection(graph.alternativeSecurityId)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="For internal use only. Not nullable." />
@@ -3969,7 +4021,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The type of operating system on the device. Required." />
         </Property>
         <Property Name="operatingSystemVersion" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The version of the operating system on the device. Required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Operating system version of the device. Required." />
         </Property>
         <Property Name="physicalIds" Type="Collection(Edm.String)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="For internal use only. Not nullable." />
@@ -4084,7 +4136,9 @@
           </Annotation>
           <Annotation Term="Org.OData.Core.V1.Description" String="Users that are members of this directory role. HTTP Methods: GET, POST, DELETE. Read-only. Nullable." />
         </NavigationProperty>
-        <NavigationProperty Name="scopedMembers" Type="Collection(graph.scopedRoleMembership)" ContainsTarget="true" />
+        <NavigationProperty Name="scopedMembers" Type="Collection(graph.scopedRoleMembership)" ContainsTarget="true">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Members of this directory role that are scoped to administrative units. Read-only. Nullable." />
+        </NavigationProperty>
       </EntityType>
       <EntityType Name="directoryRoleTemplate" BaseType="graph.directoryObject" OpenType="true">
         <Property Name="description" Type="Edm.String">
@@ -4096,7 +4150,7 @@
       </EntityType>
       <EntityType Name="domain" BaseType="graph.entity">
         <Property Name="authenticationType" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the configured authentication type for the domain. The value is either Managed or Federated. Managed indicates a cloud managed domain where Azure AD performs user authentication.Federated indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. This property is read-only and is not nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the configured authentication type for the domain. The value is either Managed or Federated. Managed indicates a cloud managed domain where Azure AD performs user authentication.Federated indicates authentication is federated with an identity provider such as the tenant's on-premises Active Directory via Active Directory Federation Services. This propert is read-only and is not nullable." />
         </Property>
         <Property Name="availabilityStatus" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="This property is always null except when the verify action is used. When the verify action is used, a domain entity is returned in the response. The availabilityStatus property of the domain entity in the response is either AvailableImmediately or EmailVerifiedDomainTakeoverScheduled." />
@@ -4202,7 +4256,7 @@
       </EntityType>
       <EntityType Name="group" BaseType="graph.directoryObject" OpenType="true">
         <Property Name="assignedLabels" Type="Collection(graph.assignedLabel)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The list of sensitivity label pairs (label ID, label name) associated with an Microsoft 365 group. Returned only on $select. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Returned only on $select." />
         </Property>
         <Property Name="assignedLicenses" Type="Collection(graph.assignedLicense)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The licenses that are assigned to the group. Returned only on $select. Read-only." />
@@ -4226,10 +4280,10 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the group type and its membership.  If the collection contains Unified, the group is a Microsoft 365 group; otherwise, it's either a security group or distribution group. For details, see groups overview.If the collection includes DynamicMembership, the group has dynamic membership; otherwise, membership is static.  Returned by default. Supports $filter." />
         </Property>
         <Property Name="hasMembersWithLicenseErrors" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether there are members in this group that have license errors from its group-based license assignment. This property is never returned on a GET operation. You can use it as a $filter argument to get groups that have members with license errors (that is, filter for this property being true). See an example." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether there are members in this group that have license errors from its group-based license assignment. This property is never returned on a GET operation. You can use it as a $filter argument to get groups that have members with license errors (that is, filter for this property being true)." />
         </Property>
         <Property Name="licenseProcessingState" Type="graph.licenseProcessingState">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates status of the group license assignment to all members of the group. Default value is false. Read-only. Possible values: QueuedForProcessing, ProcessingInProgress, and ProcessingComplete.Returned only on $select. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates status of the group license assignment to all members of the group. Possible values: QueuedForProcessing, ProcessingInProgress, and ProcessingComplete. Returned only on $select. Read-only." />
         </Property>
         <Property Name="mail" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The SMTP address for the group, for example, 'serviceadmins@contoso.onmicrosoft.com'. Returned by default. Read-only. Supports $filter." />
@@ -4237,17 +4291,27 @@
         <Property Name="mailEnabled" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies whether the group is mail-enabled. Returned by default." />
         </Property>
-        <Property Name="mailNickname" Type="Edm.String" />
+        <Property Name="mailNickname" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The mail alias for the group, unique in the organization. This property must be specified when a group is created. These characters cannot be used in the mailNickName: @()/[]';:.&lt;&gt;,SPACE. Returned by default. Supports $filter." />
+        </Property>
         <Property Name="membershipRule" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The rule that determines members for this group if the group is a dynamic group (groupTypes contains DynamicMembership). For more information about the syntax of the membership rule, see Membership Rules syntax. Returned by default." />
         </Property>
         <Property Name="membershipRuleProcessingState" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the dynamic membership processing is on or paused. Possible values are 'On' or 'Paused'. Returned by default." />
         </Property>
-        <Property Name="onPremisesDomainName" Type="Edm.String" />
-        <Property Name="onPremisesLastSyncDateTime" Type="Edm.DateTimeOffset" />
-        <Property Name="onPremisesNetBiosName" Type="Edm.String" />
-        <Property Name="onPremisesProvisioningErrors" Type="Collection(graph.onPremisesProvisioningError)" />
+        <Property Name="onPremisesDomainName" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.Returned by default. Read-only." />
+        </Property>
+        <Property Name="onPremisesLastSyncDateTime" Type="Edm.DateTimeOffset">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the last time at which the group was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only. Supports $filter." />
+        </Property>
+        <Property Name="onPremisesNetBiosName" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises netBios name synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.Returned by default. Read-only." />
+        </Property>
+        <Property Name="onPremisesProvisioningErrors" Type="Collection(graph.onPremisesProvisioningError)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Errors when using Microsoft synchronization product during provisioning. Returned by default." />
+        </Property>
         <Property Name="onPremisesSamAccountName" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Contains the on-premises SAM account name synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.Returned by default. Read-only." />
         </Property>
@@ -4261,10 +4325,10 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The preferred data location for the group. For more information, see  OneDrive Online Multi-Geo. Returned by default." />
         </Property>
         <Property Name="preferredLanguage" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The preferred language for an Microsoft 365 group. Should follow ISO 639-1 Code; for example 'en-US'. Returned by default." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The preferred language for a Microsoft 365 group. Should follow ISO 639-1 Code; for example 'en-US'. Returned by default." />
         </Property>
         <Property Name="proxyAddresses" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Email addresses for the group that direct to the same group mailbox. For example: ['SMTP: bob@contoso.com', 'smtp: bob@sales.contoso.com']. The any operator is required to filter expressions on multi-valued properties. Returned by default. Read-only. Not nullable. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Email addresses for the group that direct to the same group mailbox. For example: ['SMTP: bob@contoso.com', 'smtp: bob@sales.contoso.com']. The any operator is required for filter expressions on multi-valued properties. Returned by default. Read-only. Not nullable. Supports $filter." />
         </Property>
         <Property Name="renewedDateTime" Type="Edm.DateTimeOffset">
           <Annotation Term="Org.OData.Core.V1.Description" String="Timestamp of when the group was last renewed. This cannot be modified directly and is only updated via the renew service action. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Returned by default. Read-only." />
@@ -4276,7 +4340,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Security identifier of the group, used in Windows scenarios. Returned by default." />
         </Property>
         <Property Name="theme" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies an Microsoft 365 group's color theme. Possible values are Teal, Purple, Green, Blue, Pink, Orange or Red. Returned by default." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies a Microsoft 365 group's color theme. Possible values are Teal, Purple, Green, Blue, Pink, Orange or Red. Returned by default." />
         </Property>
         <Property Name="visibility" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the visibility of a Microsoft 365 group. Possible values are: Private, Public, or Hiddenmembership; blank values are treated as public.  See group visibility options to learn more.Visibility can be set only when a group is created; it is not editable.Visibility is supported only for unified groups; it is not supported for security groups. Returned by default." />
@@ -4288,21 +4352,21 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates if new members added to the group will be auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group. Default value is false. Returned only on $select." />
         </Property>
         <Property Name="hideFromAddressLists" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="True if the group is not displayed in certain parts of the Outlook UI: the Address Book, address lists for selecting message recipients, and the Browse Groups dialog for searching groups; otherwise, false. Default value is false. Returned only on $select." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="True if the group is not displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups; false otherwise. Default value is false. Returned only on $select." />
         </Property>
         <Property Name="hideFromOutlookClients" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="True if the group is not displayed in Outlook clients, such as Outlook for Windows and Outlook on the web; otherwise, false. Default value is false. Returned only on $select." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="True if the group is not displayed in Outlook clients, such as Outlook for Windows and Outlook on the web, false otherwise. Default value is false. Returned only on $select." />
         </Property>
         <Property Name="isSubscribedByMail" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the signed-in user is subscribed to receive email conversations. Default value is true. Returned only on $select." />
         </Property>
         <Property Name="unseenCount" Type="Edm.Int32">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Count of conversations that have received new posts since the signed-in user last visited the group. Returned only on $select." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Returned only on $select." />
         </Property>
         <Property Name="isArchived" Type="Edm.Boolean" />
         <NavigationProperty Name="appRoleAssignments" Type="Collection(graph.appRoleAssignment)" ContainsTarget="true" />
         <NavigationProperty Name="createdOnBehalfOf" Type="graph.directoryObject">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The user (or application) that created the group. NOTE: This is not set if the user is an administrator. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The user (or application) that created the group. Note: This is not set if the user is an administrator. Read-only." />
         </NavigationProperty>
         <NavigationProperty Name="memberOf" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
@@ -4315,7 +4379,7 @@
               <String>microsoft.graph.orgContact</String>
             </Collection>
           </Annotation>
-          <Annotation Term="Org.OData.Core.V1.Description" String="Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Groups and administrative units that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="members" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
@@ -4328,7 +4392,7 @@
               <String>microsoft.graph.orgContact</String>
             </Collection>
           </Annotation>
-          <Annotation Term="Org.OData.Core.V1.Description" String="Users and groups that are members of this group. HTTP Methods: GET (supported for all groups), POST (supported for Microsoft 365 groups, security groups and mail-enabled security groups), DELETE (supported for Microsoft 365 groups and security groups). Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Users, contacts, and groups that are members of this group. HTTP Methods: GET (supported for all groups), POST (supported for security groups and mail-enabled security groups), DELETE (supported only for security groups) Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="membersWithLicenseErrors" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
@@ -4354,11 +4418,11 @@
               <String>microsoft.graph.orgContact</String>
             </Collection>
           </Annotation>
-          <Annotation Term="Org.OData.Core.V1.Description" String="The owners of the group. The owners are a set of non-admin users who are allowed to modify this object. Limited to 100 owners. HTTP Methods: GET (supported for all groups), POST (supported for Microsoft 365 groups, security groups and mail-enabled security groups), DELETE (supported for Microsoft 365 groups and security groups). Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The owners of the group. The owners are a set of non-admin users who are allowed to modify this object. HTTP Methods: GET (supported for all groups), POST (supported for security groups and mail-enabled security groups), DELETE (supported only for security groups) Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="permissionGrants" Type="Collection(graph.resourceSpecificPermissionGrant)" ContainsTarget="true" />
         <NavigationProperty Name="settings" Type="Collection(graph.groupSetting)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Settings that can govern this group's behavior, like whether members can invite guest users to the group. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="transitiveMemberOf" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
@@ -4384,7 +4448,7 @@
             </Collection>
           </Annotation>
         </NavigationProperty>
-        <NavigationProperty Name="acceptedSenders" Type="Collection(graph.directoryObject)" ContainsTarget="true">
+        <NavigationProperty Name="acceptedSenders" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The list of users or groups that are allowed to create post's or calendar events in this group. If this list is non-empty then only users or groups listed here are allowed to post." />
         </NavigationProperty>
         <NavigationProperty Name="calendar" Type="graph.calendar" ContainsTarget="true">
@@ -4397,15 +4461,15 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The group's conversations." />
         </NavigationProperty>
         <NavigationProperty Name="events" Type="Collection(graph.event)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The group's calendar events." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The group's events." />
         </NavigationProperty>
         <NavigationProperty Name="photo" Type="graph.profilePhoto" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The group's profile photo" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The group's profile photo." />
         </NavigationProperty>
         <NavigationProperty Name="photos" Type="Collection(graph.profilePhoto)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The profile photos owned by the group. Read-only. Nullable." />
         </NavigationProperty>
-        <NavigationProperty Name="rejectedSenders" Type="Collection(graph.directoryObject)" ContainsTarget="true">
+        <NavigationProperty Name="rejectedSenders" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Core.V1.Description" String="The list of users or groups that are not allowed to create posts or calendar events in this group. Nullable" />
         </NavigationProperty>
         <NavigationProperty Name="threads" Type="Collection(graph.conversationThread)" ContainsTarget="true">
@@ -4427,7 +4491,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of lifecycle policies for this group. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="planner" Type="graph.plannerGroup" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Entry-point to Planner resource that might exist for a Unified Group." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Selective Planner services available to the group. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="onenote" Type="graph.onenote" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Read-only." />
@@ -4533,7 +4597,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of service plans associated with the tenant. Not nullable." />
         </Property>
         <Property Name="businessPhones" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Telephone number for the organization. NOTE: Although this is a string collection, only one number can be set for this property." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Telephone number for the organization. Note: Although this is a string collection, only one number can be set for this property." />
         </Property>
         <Property Name="city" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="City name of the address for the organization." />
@@ -4554,7 +4618,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Not nullable." />
         </Property>
         <Property Name="onPremisesLastSyncDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The time and date at which the tenant was last synced with the on-premise directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The time and date at which the tenant was last synced with the on-premise directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'." />
         </Property>
         <Property Name="onPremisesSyncEnabled" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default)." />
@@ -4590,27 +4654,55 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Mobile device management authority. Possible values are: unknown, intune, sccm, office365." />
         </Property>
         <NavigationProperty Name="certificateBasedAuthConfiguration" Type="Collection(graph.certificateBasedAuthConfiguration)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Navigation property to manage certificate-based authentication configuration. Only a single instance of certificateBasedAuthConfiguration can be created in the collection." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Navigation property to manage  certificate-based authentication configuration. Only a single instance of certificateBasedAuthConfiguration can be created in the collection." />
         </NavigationProperty>
         <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the organization. Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the organization resource. Nullable." />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="orgContact" BaseType="graph.directoryObject" OpenType="true">
-        <Property Name="addresses" Type="Collection(graph.physicalOfficeAddress)" />
-        <Property Name="companyName" Type="Edm.String" />
-        <Property Name="department" Type="Edm.String" />
-        <Property Name="displayName" Type="Edm.String" />
-        <Property Name="givenName" Type="Edm.String" />
-        <Property Name="jobTitle" Type="Edm.String" />
-        <Property Name="mail" Type="Edm.String" />
-        <Property Name="mailNickname" Type="Edm.String" />
-        <Property Name="onPremisesLastSyncDateTime" Type="Edm.DateTimeOffset" />
-        <Property Name="onPremisesProvisioningErrors" Type="Collection(graph.onPremisesProvisioningError)" />
-        <Property Name="onPremisesSyncEnabled" Type="Edm.Boolean" />
-        <Property Name="phones" Type="Collection(graph.phone)" />
-        <Property Name="proxyAddresses" Type="Collection(Edm.String)" Nullable="false" />
-        <Property Name="surname" Type="Edm.String" />
+        <Property Name="addresses" Type="Collection(graph.physicalOfficeAddress)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Postal addresses for this organizational contact. For now a contact can only have one physical address." />
+        </Property>
+        <Property Name="companyName" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the company that this organizational contact belong to." />
+        </Property>
+        <Property Name="department" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name for the department in which the contact works." />
+        </Property>
+        <Property Name="displayName" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Display name for this organizational contact." />
+        </Property>
+        <Property Name="givenName" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="First name for this organizational contact." />
+        </Property>
+        <Property Name="jobTitle" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Job title for this organizational contact." />
+        </Property>
+        <Property Name="mail" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The SMTP address for the contact, for example, 'jeff@contoso.onmicrosoft.com'." />
+        </Property>
+        <Property Name="mailNickname" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Email alias (portion of email address pre-pending the @ symbol) for this organizational contact." />
+        </Property>
+        <Property Name="onPremisesLastSyncDateTime" Type="Edm.DateTimeOffset">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Date and time when this organizational contact was last synchronized from on-premises AD. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'." />
+        </Property>
+        <Property Name="onPremisesProvisioningErrors" Type="Collection(graph.onPremisesProvisioningError)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="List of any synchronization provisioning errors for this organizational contact." />
+        </Property>
+        <Property Name="onPremisesSyncEnabled" Type="Edm.Boolean">
+          <Annotation Term="Org.OData.Core.V1.Description" String="true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced and now mastered in Exchange; null if this object has never been synced from an on-premises directory (default)." />
+        </Property>
+        <Property Name="phones" Type="Collection(graph.phone)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="List of phones for this organizational contact. Phone types can be mobile, business, and businessFax. Only one of each type can ever be present in the collection." />
+        </Property>
+        <Property Name="proxyAddresses" Type="Collection(Edm.String)" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="For example: 'SMTP: bob@contoso.com', 'smtp: bob@sales.contoso.com'. The any operator is required for filter expressions on multi-valued properties. Supports $filter." />
+        </Property>
+        <Property Name="surname" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Last name for this organizational contact." />
+        </Property>
         <NavigationProperty Name="directReports" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
             <Collection>
@@ -4618,8 +4710,11 @@
               <String>microsoft.graph.orgContact</String>
             </Collection>
           </Annotation>
+          <Annotation Term="Org.OData.Core.V1.Description" String="The contact's direct reports. (The users and contacts that have their manager property set to this contact.) Read-only. Nullable." />
+        </NavigationProperty>
+        <NavigationProperty Name="manager" Type="graph.directoryObject">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The user or contact that is this contact's manager. Read-only." />
         </NavigationProperty>
-        <NavigationProperty Name="manager" Type="graph.directoryObject" />
         <NavigationProperty Name="memberOf" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
             <Collection>
@@ -4631,6 +4726,7 @@
               <String>microsoft.graph.orgContact</String>
             </Collection>
           </Annotation>
+          <Annotation Term="Org.OData.Core.V1.Description" String="Groups that this contact is a member of. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="transitiveMemberOf" Type="Collection(graph.directoryObject)">
           <Annotation Term="Org.OData.Validation.V1.DerivedTypeConstraint">
@@ -4662,7 +4758,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The permission classification for the permission being granted, or 'all' to match with any permission classification (including permissions which are not classified). Default is all." />
         </Property>
         <Property Name="permissions" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The list of id values for the specific permissions to match with, or a list with the single value 'all' to match with any permission. The id of delegated permissions can be found in the oauth2PermissionScopes property of the API's **servicePrincipal** object. The id of application permissions can be found in the appRoles property of the API's **servicePrincipal** object. The id of resource-specific application permissions can be found in the resourceSpecificApplicationPermissions property of the API's **servicePrincipal** object. Default is the single value 'all'." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The list of id values for the specific permissions to match with, or a list with the single value 'all' to match with any permission. The id of delegated permissions can be found in the publishedPermissionScopes property of the API's **servicePrincipal** object. The id of application permissions can be found in the appRoles property of the API's **servicePrincipal** object. The id of resource-specific application permissions can be found in the resourceSpecificApplicationPermissions property of the API's **servicePrincipal** object. Default is the single value 'all'." />
         </Property>
         <Property Name="permissionType" Type="graph.permissionType">
           <Annotation Term="Org.OData.Core.V1.Description" String="The permission type of the permission being granted. Possible values: application for application permissions (e.g. app roles) or delegated for delegated permissions. The value delegatedUserConsentable indicates delegated permissions which have not been configured by the API publisher to require admin consent—this value may be used in built-in permission grant policies, but cannot be used in custom permission grant policies. Required." />
@@ -4697,7 +4793,9 @@
         <Property Name="createdDateTime" Type="Edm.DateTimeOffset">
           <Annotation Term="Org.OData.Core.V1.Description" String="The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Readonly." />
         </Property>
-        <Property Name="description" Type="Edm.String" />
+        <Property Name="description" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Not used." />
+        </Property>
         <Property Name="displayName" Type="Edm.String" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies a display name for the conditionalAccessPolicy object." />
         </Property>
@@ -4762,13 +4860,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Name of the class in the syncing system." />
         </Property>
         <Property Name="externalSource" Type="graph.educationExternalSource">
-          <Annotation Term="Org.OData.Core.V1.Description" String="How this class was created. The possible values are: sis, manual, unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of external source this resource was generated from (automatically determined from externalSourceDetail). Possible values are: sis, lms, or manual." />
         </Property>
         <Property Name="mailNickname" Type="Edm.String" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Mail name for sending email to all members, if this is enabled." />
         </Property>
         <Property Name="term" Type="graph.educationTerm">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Term for this class." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Term for the class." />
         </Property>
         <NavigationProperty Name="group" Type="graph.group">
           <Annotation Term="Org.OData.Core.V1.Description" String="The directory group corresponding to this class." />
@@ -4785,7 +4883,7 @@
       </EntityType>
       <EntityType Name="educationUser" BaseType="graph.entity">
         <Property Name="accountEnabled" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="True if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="True if the account is enabled; otherwise, false. This property is required when a user is created. Supports /$filter." />
         </Property>
         <Property Name="assignedLicenses" Type="Collection(graph.assignedLicense)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The licenses that are assigned to the user. Not nullable." />
@@ -4800,25 +4898,25 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Entity who created the user." />
         </Property>
         <Property Name="department" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The name for the department in which the user works. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name for the department in which the user works. Supports /$filter." />
         </Property>
         <Property Name="displayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and last name. This property is required when a user is created and it cannot be cleared during updates. Supports $filter and $orderby." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name displayed in the address book for the user. Supports $filter and $orderby." />
         </Property>
         <Property Name="externalSource" Type="graph.educationExternalSource">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Where this user was created from. The possible values are: sis, manual." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of external source this resource was generated from (automatically determined from externalSourceDetail). Possible values are: sis, lms, or manual." />
         </Property>
         <Property Name="givenName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The given name (first name) of the user. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The given name (first name) of the user. Supports /$filter." />
         </Property>
         <Property Name="mail" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The SMTP address for the user; for example, 'jeff@contoso.onmicrosoft.com'. Read-Only. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The SMTP address for the user; for example, 'jeff@contoso.onmicrosoft.com'. Read-Only. Supports /$filter." />
         </Property>
         <Property Name="mailingAddress" Type="graph.physicalAddress">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Mail address of user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Mail address of user. Note: type and postOfficeBox are not supported for educationUser resources." />
         </Property>
         <Property Name="mailNickname" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The mail alias for the user. This property must be specified when a user is created. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The mail alias for the user. This property must be specified when a user is created. Supports /$filter." />
         </Property>
         <Property Name="middleName" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The middle name of user." />
@@ -4828,42 +4926,42 @@
         </Property>
         <Property Name="officeLocation" Type="Edm.String" />
         <Property Name="passwordPolicies" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies password policies for the user. This value is an enumeration with one possible value being 'DisableStrongPassword', which allows weaker passwords than the default policy to be specified. 'DisablePasswordExpiration' can also be specified. The two can be specified together; for example: 'DisablePasswordExpiration, DisableStrongPassword'." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies password policies for the user. See standard [user] resource for additional details." />
         </Property>
         <Property Name="passwordProfile" Type="graph.passwordProfile">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the password profile for the user. The profile contains the user's password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the password profile for the user. The profile contains the user's password. This property is required when a user is created. See standard [user] resource for additional details." />
         </Property>
         <Property Name="preferredLanguage" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The preferred language for the user. Should follow ISO 639-1 Code; for example, 'en-US'." />
         </Property>
         <Property Name="primaryRole" Type="graph.educationUserRole" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Default role for a user. The user's role might be different in an individual class. The possible values are: student, teacher. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Default role for a user. The user's role might be different in an individual class. Possible values are: student, teacher, faculty. Supports /$filter." />
         </Property>
         <Property Name="provisionedPlans" Type="Collection(graph.provisionedPlan)" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The plans that are provisioned for the user. Read-only. Not nullable." />
         </Property>
         <Property Name="refreshTokensValidFromDateTime" Type="Edm.DateTimeOffset" />
         <Property Name="residenceAddress" Type="graph.physicalAddress">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Address where user lives." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Address where user lives. Note: type and postOfficeBox are not supported for educationUser resources." />
         </Property>
         <Property Name="showInAddressList" Type="Edm.Boolean" />
         <Property Name="student" Type="graph.educationStudent">
           <Annotation Term="Org.OData.Core.V1.Description" String="If the primary role is student, this block will contain student specific data." />
         </Property>
         <Property Name="surname" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The user's surname (family name or last name). Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The user's surname (family name or last name). Supports /$filter." />
         </Property>
         <Property Name="teacher" Type="graph.educationTeacher">
           <Annotation Term="Org.OData.Core.V1.Description" String="If the primary role is teacher, this block will contain teacher specific data." />
         </Property>
         <Property Name="usageLocation" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A two-letter country code (ISO standard 3166). Required for users who will be assigned licenses due to a legal requirement to check for availability of services in countries or regions. Examples include: 'US', 'JP', and 'GB'. Not nullable. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A two-letter country code ([ISO 3166 Alpha-2]). Required for users who will be assigned licenses. Not nullable. Supports /$filter." />
         </Property>
         <Property Name="userPrincipalName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant's collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The user principal name (UPN) for the user. Supports $filter and $orderby. See standard [user] resource for additional details." />
         </Property>
         <Property Name="userType" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A string value that can be used to classify user types in your directory, such as 'Member' and 'Guest'. Supports $filter." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A string value that can be used to classify user types in your directory, such as 'Member' and 'Guest'. Supports /$filter." />
         </Property>
         <NavigationProperty Name="classes" Type="Collection(graph.educationClass)">
           <Annotation Term="Org.OData.Core.V1.Description" String="Classes to which the user belongs. Nullable." />
@@ -4883,7 +4981,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Organization display name." />
         </Property>
         <Property Name="externalSource" Type="graph.educationExternalSource">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Source where this organization was created from. The possible values are: sis, manual, unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Where this user was created from. Possible values are: sis, lms, or manual." />
         </Property>
       </EntityType>
       <EntityType Name="educationSchool" BaseType="graph.educationOrganization">
@@ -4971,7 +5069,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="If present, indicates that this item is a package instead of a folder or file. Packages are treated like files in some contexts and folders in others. Read-only." />
         </Property>
         <Property Name="pendingOperations" Type="graph.pendingOperations">
-          <Annotation Term="Org.OData.Core.V1.Description" String="If present, indicates that one or more operations that might affect the state of the driveItem are pending completion. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="If present, indicates that indicates that one or more operations that may affect the state of the driveItem are pending completion. Read-only." />
         </Property>
         <Property Name="photo" Type="graph.photo">
           <Annotation Term="Org.OData.Core.V1.Description" String="Photo metadata, if the item is a photo. Read-only." />
@@ -5068,7 +5166,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents a collection of workbook scoped named items (named ranges and constants). Read-only." />
         </NavigationProperty>
         <NavigationProperty Name="operations" Type="Collection(graph.workbookOperation)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The status of workbook operations. Getting an operation collection is not supported, but you can get the status of a long-running operation if the Location header is returned in the response. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The status of Workbook operations. Getting an operation collection is not supported, but you can get the status of a long-running operation if the Location header is returned in the response. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="tables" Type="Collection(graph.workbookTable)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents a collection of tables associated with the workbook. Read-only." />
@@ -5128,7 +5226,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The type of permission, e.g. read. See below for the full list of roles. Read-only." />
         </Property>
         <Property Name="shareId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A unique token that can be used to access this shared item via the **shares** API. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A unique token that can be used to access this shared item via the [shares API][]. Read-only." />
         </Property>
       </EntityType>
       <EntityType Name="subscription" BaseType="graph.entity">
@@ -5136,22 +5234,22 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Identifier of the application used to create the subscription. Read-only." />
         </Property>
         <Property Name="changeType" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: created, updated, deleted. Multiple values can be combined using a comma-separated list.Note: Drive root item and list change notifications support only the updated changeType. User and group change notifications support updated and deleted changeType." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: created, updated, deleted. Multiple values can be combined using a comma-separated list. Required. Note: Drive root item and list change notifications support only the updated changeType. User and group change notifications support updated and deleted changeType." />
         </Property>
         <Property Name="clientState" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 128 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification. Optional." />
         </Property>
         <Property Name="creatorId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the id of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the id of the service principal corresponding to the app. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the ID of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the ID of the service principal corresponding to the app. Read-only." />
         </Property>
         <Property Name="encryptionCertificate" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional. Required when includeResourceData is true." />
         </Property>
         <Property Name="encryptionCertificateId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Optional." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Optional. Required when includeResourceData is true." />
         </Property>
         <Property Name="expirationDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to.  See the table below for maximum supported subscription length of time." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to.  See the table below for maximum supported subscription length of time. Required." />
         </Property>
         <Property Name="includeResourceData" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="When set to true, change notifications include resource data (such as content of a chat message). Optional." />
@@ -5163,10 +5261,10 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The URL of the endpoint that receives lifecycle notifications, including subscriptionRemoved and missed notifications. This URL must make use of the HTTPS protocol. Optional. Read more about how Outlook resources use lifecycle notifications." />
         </Property>
         <Property Name="notificationUrl" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Required. The URL of the endpoint that will receive the change notifications. This URL must make use of the HTTPS protocol." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The URL of the endpoint that receives the change notifications. This URL must make use of the HTTPS protocol. Required." />
         </Property>
         <Property Name="resource" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Required. Specifies the resource that will be monitored for changes. Do not include the base URL (https://graph.microsoft.com/v1.0/). See the possible resource path values for each supported resource." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the resource that will be monitored for changes. Do not include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource. Required." />
         </Property>
       </EntityType>
       <EntityType Name="thumbnailSet" BaseType="graph.entity" OpenType="true">
@@ -5195,9 +5293,7 @@
         </Property>
       </EntityType>
       <EntityType Name="driveItemVersion" BaseType="graph.baseItemVersion">
-        <Property Name="content" Type="Edm.Stream">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The content stream for this version of the item." />
-        </Property>
+        <Property Name="content" Type="Edm.Stream" />
         <Property Name="size" Type="Edm.Int64">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the size of the content stream for this version of the item." />
         </Property>
@@ -5303,7 +5399,7 @@
       </EntityType>
       <EntityType Name="workbookComment" BaseType="graph.entity">
         <Property Name="content" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The content of comment." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The content of the comment." />
         </Property>
         <Property Name="contentType" Type="Edm.String" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type for the comment." />
@@ -5324,7 +5420,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the name is scoped to the workbook or to a specific worksheet. Read-only." />
         </Property>
         <Property Name="type" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates what type of reference is associated with the name. The possible values are: String, Integer, Double, Boolean, Range. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates what type of reference is associated with the name. Possible values are: String, Integer, Double, Boolean, Range. Read-only." />
         </Property>
         <Property Name="value" Type="graph.Json">
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the formula that the name is defined to refer to. E.g. =Sheet14!$B$2:$H$12, =4.75, etc. Read-only." />
@@ -5344,7 +5440,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The resource URI for the result." />
         </Property>
         <Property Name="status" Type="graph.workbookOperationStatus" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The current status of the operation. Possible values are: NotStarted, Running, Completed, Failed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The current status of the operation. Possible values are: notStarted, running, succeeded, failed." />
         </Property>
       </EntityType>
       <EntityType Name="workbookTable" BaseType="graph.entity">
@@ -5376,7 +5472,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the total row is visible or not. This value can be set to show or remove the total row." />
         </Property>
         <Property Name="style" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Constant value that represents the Table style. The possible values are: TableStyleLight1 thru TableStyleLight21, TableStyleMedium1 thru TableStyleMedium28, TableStyleStyleDark1 thru TableStyleStyleDark11. A custom user-defined style present in the workbook can also be specified." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Constant value that represents the Table style. Possible values are: TableStyleLight1 thru TableStyleLight21, TableStyleMedium1 thru TableStyleMedium28, TableStyleStyleDark1 thru TableStyleStyleDark11. A custom user-defined style present in the workbook can also be specified." />
         </Property>
         <NavigationProperty Name="columns" Type="Collection(graph.workbookTableColumn)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents a collection of all the columns in the table. Read-only." />
@@ -5678,10 +5774,10 @@
       </EntityType>
       <EntityType Name="workbookCommentReply" BaseType="graph.entity">
         <Property Name="content" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The content of a comment reply." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The content of replied comment." />
         </Property>
         <Property Name="contentType" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type for the comment reply." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type for the replied comment." />
         </Property>
       </EntityType>
       <EntityType Name="workbookFilter" BaseType="graph.entity">
@@ -5759,7 +5855,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the raw values of the specified range. The data returned could be of type string, number, or a boolean. Cell that contain an error will return the error string." />
         </Property>
         <Property Name="valueTypes" Type="graph.Json">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the type of data of each cell. The possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the type of data of each cell. Possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error. Read-only." />
         </Property>
         <NavigationProperty Name="format" Type="graph.workbookRangeFormat" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only." />
@@ -5776,13 +5872,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Gets or sets the width of all colums within the range. If the column widths are not uniform, null will be returned." />
         </Property>
         <Property Name="horizontalAlignment" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the horizontal alignment for the specified object. The possible values are: General, Left, Center, Right, Fill, Justify, CenterAcrossSelection, Distributed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the horizontal alignment for the specified object. Possible values are: General, Left, Center, Right, Fill, Justify, CenterAcrossSelection, Distributed." />
         </Property>
         <Property Name="rowHeight" Type="Edm.Double">
           <Annotation Term="Org.OData.Core.V1.Description" String="Gets or sets the height of all rows in the range. If the row heights are not uniform null will be returned." />
         </Property>
         <Property Name="verticalAlignment" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the vertical alignment for the specified object. The possible values are: Top, Center, Bottom, Justify, Distributed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the vertical alignment for the specified object. Possible values are: Top, Center, Bottom, Justify, Distributed." />
         </Property>
         <Property Name="wrapText" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates if Excel wraps the text in the object. A null value indicates that the entire range doesn't have uniform wrap setting" />
@@ -5806,13 +5902,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="HTML color code representing the color of the border line, of the form #RRGGBB (e.g. 'FFA500') or as a named HTML color (e.g. 'orange')." />
         </Property>
         <Property Name="sideIndex" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Constant value that indicates the specific side of the border. The possible values are: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, DiagonalUp. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Constant value that indicates the specific side of the border. Possible values are: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, DiagonalUp. Read-only." />
         </Property>
         <Property Name="style" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="One of the constants of line style specifying the line style for the border. The possible values are: None, Continuous, Dash, DashDot, DashDotDot, Dot, Double, SlantDashDot." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="One of the constants of line style specifying the line style for the border. Possible values are: None, Continuous, Dash, DashDot, DashDotDot, Dot, Double, SlantDashDot." />
         </Property>
         <Property Name="weight" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the weight of the border around a range. The possible values are: Hairline, Thin, Medium, Thick." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the weight of the border around a range. Possible values are: Hairline, Thin, Medium, Thick." />
         </Property>
       </EntityType>
       <EntityType Name="workbookRangeFill" BaseType="graph.entity">
@@ -5837,7 +5933,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Font size." />
         </Property>
         <Property Name="underline" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Type of underline applied to the font. The possible values are: None, Single, Double, SingleAccountant, DoubleAccountant." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Type of underline applied to the font. Possible values are: None, Single, Double, SingleAccountant, DoubleAccountant." />
         </Property>
       </EntityType>
       <EntityType Name="workbookRangeView" BaseType="graph.entity">
@@ -5872,7 +5968,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the raw values of the specified range view. The data returned could be of type string, number, or a boolean. Cell that contain an error will return the error string." />
         </Property>
         <Property Name="valueTypes" Type="graph.Json">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the type of data of each cell. Read-only. The possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the type of data of each cell. Read-only. Possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error." />
         </Property>
         <NavigationProperty Name="rows" Type="Collection(graph.workbookRangeView)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents a collection of range views associated with the range. Read-only.&#x9;Read-only." />
@@ -5908,7 +6004,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents whether the casing impacted the last sort of the table. Read-only." />
         </Property>
         <Property Name="method" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents Chinese character ordering method last used to sort the table. The possible values are: PinYin, StrokeCount. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents Chinese character ordering method last used to sort the table. Possible values are: PinYin, StrokeCount. Read-only." />
         </Property>
       </EntityType>
       <EntityType Name="workbookWorksheetProtection" BaseType="graph.entity">
@@ -5991,7 +6087,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
         </Property>
         <Property Name="name" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The attachment's file name." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the attachment. This does not need to be the actual file name." />
         </Property>
         <Property Name="size" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The length of the attachment in bytes." />
@@ -6056,13 +6152,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property." />
         </Property>
         <NavigationProperty Name="attachments" Type="Collection(graph.attachment)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the post. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="extensions" Type="Collection(graph.extension)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of open extensions defined for the post. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="inReplyTo" Type="graph.post" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The earlier post that this post is replying to in the conversationThread. Read-only." />
         </NavigationProperty>
         <NavigationProperty Name="multiValueExtendedProperties" Type="Collection(graph.multiValueLegacyExtendedProperty)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of multi-value extended properties defined for the post. Read-only. Nullable." />
@@ -6072,7 +6168,9 @@
         </NavigationProperty>
       </EntityType>
       <EntityType Name="eventMessage" BaseType="graph.message">
-        <Property Name="endDateTime" Type="graph.dateTimeTimeZone" />
+        <Property Name="endDateTime" Type="graph.dateTimeTimeZone">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The end time of the requested meeting." />
+        </Property>
         <Property Name="isAllDay" Type="Edm.Boolean" />
         <Property Name="isDelegated" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="True if this meeting request is accessible to a delegate, false otherwise. Default is false." />
@@ -6124,7 +6222,7 @@
       </EntityType>
       <EntityType Name="inferenceClassificationOverride" BaseType="graph.entity">
         <Property Name="classifyAs" Type="graph.inferenceClassificationType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies how incoming messages from a specific sender should always be classified as. The possible values are: focused, other." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies how incoming messages from a specific sender should always be classified as. Possible values are: focused, other." />
         </Property>
         <Property Name="senderEmailAddress" Type="graph.emailAddress">
           <Annotation Term="Org.OData.Core.V1.Description" String="The email address information of the sender for whom the override is created." />
@@ -6132,7 +6230,7 @@
       </EntityType>
       <EntityType Name="itemAttachment" BaseType="graph.attachment">
         <NavigationProperty Name="item" Type="graph.outlookItem" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The attached message or event. Navigation property." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The attached contact, message or event. Navigation property." />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="messageRule" BaseType="graph.entity">
@@ -6177,7 +6275,7 @@
       </EntityType>
       <EntityType Name="openTypeExtension" BaseType="graph.extension" OpenType="true">
         <Property Name="extensionName" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A unique text identifier for an open type open extension. Required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A unique text identifier for an open type data extension. Required." />
         </Property>
       </EntityType>
       <EntityType Name="outlookCategory" BaseType="graph.entity">
@@ -6286,7 +6384,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The lifecycle state of the schema extension. Possible states are InDevelopment, Available, and Deprecated. Automatically set to InDevelopment on creation. Schema extensions provides more information on the possible state transitions and behaviors." />
         </Property>
         <Property Name="targetTypes" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Set of Microsoft Graph types (that can support extensions) that the schema extension can be applied to. Select from contact, device, event, group, message, organization, post, or user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Set of Microsoft Graph types (that can support extensions) that the schema extension can be applied to. Select from administrativeUnit, contact, device, event, group, message, organization, post, or user." />
         </Property>
       </EntityType>
       <EntityType Name="cloudCommunications" BaseType="graph.entity">
@@ -6307,20 +6405,22 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The routing information on how the call was retargeted. Read-only." />
         </Property>
         <Property Name="chatInfo" Type="graph.chatInfo">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The chat information. Required information for joining a meeting." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The chat information. Required information for meeting scenarios." />
         </Property>
         <Property Name="direction" Type="graph.callDirection">
           <Annotation Term="Org.OData.Core.V1.Description" String="The direction of the call. The possible value are incoming or outgoing. Read-only." />
         </Property>
-        <Property Name="incomingContext" Type="graph.incomingContext" />
+        <Property Name="incomingContext" Type="graph.incomingContext">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The context associated with an incoming call. Read-only. Server generated." />
+        </Property>
         <Property Name="mediaConfig" Type="graph.mediaConfig">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The media configuration. Required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The media configuration. Required information for creating peer to peer calls or joining meetings." />
         </Property>
         <Property Name="mediaState" Type="graph.callMediaState">
           <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. The call media state." />
         </Property>
         <Property Name="meetingInfo" Type="graph.meetingInfo">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The meeting information that's required for joining a meeting." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The meeting information. Required information for meeting scenarios." />
         </Property>
         <Property Name="myParticipantId" Type="Edm.String" />
         <Property Name="requestedModalities" Type="Collection(graph.modality)" />
@@ -6331,7 +6431,9 @@
         <Property Name="targets" Type="Collection(graph.invitationParticipantInfo)" />
         <Property Name="tenantId" Type="Edm.String" />
         <Property Name="toneInfo" Type="graph.toneInfo" />
-        <Property Name="transcription" Type="graph.callTranscriptionInfo" />
+        <Property Name="transcription" Type="graph.callTranscriptionInfo">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The transcription information for the call. Read-only." />
+        </Property>
         <NavigationProperty Name="operations" Type="Collection(graph.commsOperation)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable." />
         </NavigationProperty>
@@ -6615,7 +6717,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Last modification date time associated with the Apple Volume Purchase Program Token." />
         </Property>
         <Property Name="lastSyncDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The last time when an application sync was done with the Apple volume purchase program service using the Apple Volume Purchase Program Token." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The last time when an application sync was done with the Apple volume purchase program service using the the Apple Volume Purchase Program Token." />
         </Property>
         <Property Name="lastSyncStatus" Type="graph.vppTokenSyncStatus" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Current sync status of the last application sync which was triggered using the Apple Volume Purchase Program Token. Possible values are: none, inProgress, completed, failed. Possible values are: none, inProgress, completed, failed." />
@@ -6624,7 +6726,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The organization associated with the Apple Volume Purchase Program Token" />
         </Property>
         <Property Name="state" Type="graph.vppTokenState" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Current state of the Apple Volume Purchase Program Token. Possible values are: unknown, valid, expired, invalid, assignedToExternalMDM. Possible values are: unknown, valid, expired, invalid, assignedToExternalMDM." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Current state of the Apple Volume Purchase Program Token. Possible values are: unknown, valid, expired, invalid, assignedToExternalMDM. Possible values are: unknown, valid, expired, invalid, assignedToExternalMDM, duplicateLocationId." />
         </Property>
         <Property Name="token" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The Apple Volume Purchase Program Token string downloaded from the Apple Volume Purchase Program." />
@@ -6743,10 +6845,10 @@
       </EntityType>
       <EntityType Name="androidManagedAppProtection" BaseType="graph.targetedManagedAppProtection">
         <Property Name="customBrowserDisplayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Friendly name of the preferred custom browser to open weblink on Android. When this property is configured, ManagedBrowserToOpenLinksRequired should be true." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Friendly name of the preferred custom browser to open weblink on Android." />
         </Property>
         <Property Name="customBrowserPackageId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Unique identifier of the preferred custom browser to open weblink on Android. When this property is configured, ManagedBrowserToOpenLinksRequired should be true." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Unique identifier of a custom browser to open weblink on Android." />
         </Property>
         <Property Name="deployedAppCount" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Count of apps to which the current policy is deployed." />
@@ -6816,7 +6918,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Type of encryption which should be used for data in a managed app. Possible values are: useDeviceSettings, afterDeviceRestart, whenDeviceLockedExceptOpenFiles, whenDeviceLocked." />
         </Property>
         <Property Name="customBrowserProtocol" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A custom browser protocol to open weblink on iOS. When this property is configured, ManagedBrowserToOpenLinksRequired should be true." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A custom browser protocol to open weblink on iOS." />
         </Property>
         <Property Name="deployedAppCount" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Count of apps to which the current policy is deployed." />
@@ -7299,7 +7401,7 @@
       </EntityType>
       <EntityType Name="win32LobApp" BaseType="graph.mobileLobApp">
         <Property Name="applicableArchitectures" Type="graph.windowsArchitecture" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The Windows architecture(s) for which this app can run on. Possible values are: none, x86, x64, arm, neutral." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Windows architecture(s) for which this app can run on. Possible values are: none, x86, x64, arm, neutral, arm64." />
         </Property>
         <Property Name="installCommandLine" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The command line to install this app" />
@@ -7354,7 +7456,7 @@
       </EntityType>
       <EntityType Name="windowsUniversalAppX" BaseType="graph.mobileLobApp">
         <Property Name="applicableArchitectures" Type="graph.windowsArchitecture" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The Windows architecture(s) for which this app can run on. Possible values are: none, x86, x64, arm, neutral." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Windows architecture(s) for which this app can run on. Possible values are: none, x86, x64, arm, neutral, arm64." />
         </Property>
         <Property Name="applicableDeviceTypes" Type="graph.windowsDeviceType" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The Windows device type(s) for which this app can run on. Possible values are: none, desktop, mobile, holographic, team." />
@@ -7477,7 +7579,9 @@
         </NavigationProperty>
       </EntityType>
       <EntityType Name="deviceManagement" BaseType="graph.entity">
-        <Property Name="intuneAccountId" Type="Edm.Guid" Nullable="false" />
+        <Property Name="intuneAccountId" Type="Edm.Guid" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Intune Account ID for given tenant" />
+        </Property>
         <Property Name="settings" Type="graph.deviceManagementSettings">
           <Annotation Term="Org.OData.Core.V1.Description" String="Account level settings." />
         </Property>
@@ -7485,7 +7589,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="intuneBrand contains data which is used in customizing the appearance of the Company Portal applications as well as the end user web portal." />
         </Property>
         <Property Name="subscriptionState" Type="graph.deviceManagementSubscriptionState" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Tenant mobile device management subscription state. The possible values are: pending, active, warning, disabled, deleted, blocked, lockedOut." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Tenant mobile device management subscription state. Possible values are: pending, active, warning, disabled, deleted, blocked, lockedOut." />
         </Property>
         <NavigationProperty Name="termsAndConditions" Type="Collection(graph.termsAndConditions)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="The terms and conditions associated with device management of the company." />
@@ -7688,7 +7792,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Number of not applicable devices" />
         </Property>
         <Property Name="platformType" Type="graph.policyPlatformType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Setting platform. Possible values are: android, iOS, macOS, windowsPhone81, windows81AndLater, windows10AndLater, androidWorkProfile, all." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Setting platform. Possible values are: android, androidForWork, iOS, macOS, windowsPhone81, windows81AndLater, windows10AndLater, androidWorkProfile, windows10XProfile, all." />
         </Property>
         <Property Name="remediatedDeviceCount" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Number of remediated devices" />
@@ -7778,7 +7882,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The device model that is being reported" />
         </Property>
         <Property Name="installStatus" Type="graph.iosUpdatesInstallStatus" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The installation status of the policy report. Possible values are: success, available, idle, unknown, downloading, downloadFailed, downloadRequiresComputer, downloadInsufficientSpace, downloadInsufficientPower, downloadInsufficientNetwork, installing, installInsufficientSpace, installInsufficientPower, installPhoneCallInProgress, installFailed, notSupportedOperation, sharedDeviceUserLoggedInError." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The installation status of the policy report. Possible values are: success, available, idle, unknown, mdmClientCrashed, timeout, downloading, downloadFailed, downloadRequiresComputer, downloadInsufficientSpace, downloadInsufficientPower, downloadInsufficientNetwork, installing, installInsufficientSpace, installInsufficientPower, installPhoneCallInProgress, installFailed, notSupportedOperation, sharedDeviceUserLoggedInError, updateError, deviceOsHigherThanDesiredOsVersion, updateScanFailed." />
         </Property>
         <Property Name="lastReportedDateTime" Type="Edm.DateTimeOffset" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Last modified date time of the policy report." />
@@ -7899,25 +8003,25 @@
       </EntityType>
       <EntityType Name="deviceEnrollmentConfiguration" BaseType="graph.entity" Abstract="true">
         <Property Name="createdDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Created date time in UTC of the device enrollment configuration" />
         </Property>
         <Property Name="description" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The description of the device enrollment configuration" />
         </Property>
         <Property Name="displayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the device enrollment configuration" />
         </Property>
         <Property Name="lastModifiedDateTime" Type="Edm.DateTimeOffset" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Last modified date time in UTC of the device enrollment configuration" />
         </Property>
         <Property Name="priority" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Priority is used when a user exists in multiple groups that are assigned enrollment configuration. Users are subject only to the configuration with the lowest priority value." />
         </Property>
         <Property Name="version" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The version of the device enrollment configuration" />
         </Property>
         <NavigationProperty Name="assignments" Type="Collection(graph.enrollmentConfigurationAssignment)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The list of group assignments for the device configuration profile." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The list of group assignments for the device configuration profile" />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="deviceManagementPartner" BaseType="graph.entity">
@@ -8054,7 +8158,7 @@
       </EntityType>
       <EntityType Name="notificationMessageTemplate" BaseType="graph.entity">
         <Property Name="brandingOptions" Type="graph.notificationTemplateBrandingOptions" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The Message Template Branding Options. Branding is defined in the Intune Admin Console. Possible values are: none, includeCompanyLogo, includeCompanyName, includeContactInformation." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Message Template Branding Options. Branding is defined in the Intune Admin Console. Possible values are: none, includeCompanyLogo, includeCompanyName, includeContactInformation, includeCompanyPortalLink." />
         </Property>
         <Property Name="defaultLocale" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The default locale to fallback onto when the requested locale is not available." />
@@ -8124,7 +8228,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Timestamp of the last request sent to Intune by the TEM partner." />
         </Property>
         <Property Name="onboardingStatus" Type="graph.remoteAssistanceOnboardingStatus" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="TBD. Possible values are: notOnboarded, onboarding, onboarded." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A friendly description of the current TeamViewer connector status. Possible values are: notOnboarded, onboarding, onboarded." />
         </Property>
         <Property Name="onboardingUrl" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="URL of the partner's onboarding portal, where an administrator can configure their Remote Assistance service." />
@@ -8581,7 +8685,7 @@
       <EntityType Name="appleDeviceFeaturesConfigurationBase" BaseType="graph.deviceConfiguration" Abstract="true" />
       <EntityType Name="deviceComplianceActionItem" BaseType="graph.entity">
         <Property Name="actionType" Type="graph.deviceComplianceActionType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="What action to take. Possible values are: noAction, notification, block, retire, wipe, removeResourceAccessProfiles, pushNotification." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="What action to take. Possible values are: noAction, notification, block, retire, wipe, removeResourceAccessProfiles, pushNotification, remoteLock." />
         </Property>
         <Property Name="gracePeriodHours" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Number of hours to wait till the action will be enforced. Valid values 0 to 8760" />
@@ -8868,13 +8972,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Edition Upgrade License File Content." />
         </Property>
         <Property Name="licenseType" Type="graph.editionUpgradeLicenseType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Edition Upgrade License Type. Possible values are: productKey, licenseFile." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Edition Upgrade License Type. Possible values are: productKey, licenseFile, notConfigured." />
         </Property>
         <Property Name="productKey" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Edition Upgrade Product Key." />
         </Property>
         <Property Name="targetEdition" Type="graph.windows10EditionType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Edition Upgrade Target Edition. Possible values are: windows10Enterprise, windows10EnterpriseN, windows10Education, windows10EducationN, windows10MobileEnterprise, windows10HolographicEnterprise, windows10Professional, windows10ProfessionalN, windows10ProfessionalEducation, windows10ProfessionalEducationN, windows10ProfessionalWorkstation, windows10ProfessionalWorkstationN." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Edition Upgrade Target Edition. Possible values are: windows10Enterprise, windows10EnterpriseN, windows10Education, windows10EducationN, windows10MobileEnterprise, windows10HolographicEnterprise, windows10Professional, windows10ProfessionalN, windows10ProfessionalEducation, windows10ProfessionalEducationN, windows10ProfessionalWorkstation, windows10ProfessionalWorkstationN, notConfigured, windows10Home, windows10HomeChina, windows10HomeN, windows10HomeSingleLanguage, windows10Mobile, windows10IoTCore, windows10IoTCoreCommercial." />
         </Property>
       </EntityType>
       <EntityType Name="iosCertificateProfile" BaseType="graph.deviceConfiguration" Abstract="true" />
@@ -8982,7 +9086,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the automatic downloading of apps purchased on other devices when the device is in supervised mode (iOS 9.0 and later)." />
         </Property>
         <Property Name="appStoreBlocked" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using the App Store." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using the App Store. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="appStoreBlockInAppPurchases" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from making in app purchases." />
@@ -9003,7 +9107,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow modification of Bluetooth settings when the device is in supervised mode (iOS 10.0 and later)." />
         </Property>
         <Property Name="cameraBlocked" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from accessing the camera of the device." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from accessing the camera of the device. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="cellularBlockDataRoaming" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block data roaming." />
@@ -9069,22 +9173,22 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from trusting an enterprise app." />
         </Property>
         <Property Name="enterpriseAppBlockTrustModification" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from modifying the enterprise app trust settings." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="[Deprecated] Configuring this setting and setting the value to 'true' has no effect on the device." />
         </Property>
         <Property Name="faceTimeBlocked" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using FaceTime." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using FaceTime. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="findMyFriendsBlocked" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block Find My Friends when the device is in supervised mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block changes to Find My Friends when the device is in supervised mode." />
         </Property>
         <Property Name="gameCenterBlocked" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using Game Center when the device is in supervised mode." />
         </Property>
         <Property Name="gamingBlockGameCenterFriends" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from having friends in Game Center." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from having friends in Game Center. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="gamingBlockMultiplayer" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using multiplayer gaming." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using multiplayer gaming. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="hostPairingBlocked" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="indicates whether or not to allow host pairing to control the devices an iOS device can pair with when the iOS device is in supervised mode." />
@@ -9099,10 +9203,10 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from continuing work they started on iOS device to another iOS or macOS device." />
         </Property>
         <Property Name="iCloudBlockBackup" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block iCloud backup." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block iCloud backup. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="iCloudBlockDocumentSync" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block iCloud document sync." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block iCloud document sync. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="iCloudBlockManagedAppsSync" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block Managed Apps Cloud Sync." />
@@ -9120,7 +9224,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to require backups to iCloud be encrypted." />
         </Property>
         <Property Name="iTunesBlockExplicitContent" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from accessing explicit content in iTunes and the App Store." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from accessing explicit content in iTunes and the App Store. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="iTunesBlockMusicService" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block Music service and revert Music app to classic mode when the device is in supervised mode (iOS 9.3 and later and macOS 10.12 and later)." />
@@ -9150,28 +9254,28 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow access to the Assistive Touch Settings while in kiosk mode." />
         </Property>
         <Property Name="kioskModeAllowAutoLock" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow device auto lock while in kiosk mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow device auto lock while in kiosk mode. This property's functionality is redundant with the OS default and is deprecated. Use KioskModeBlockAutoLock instead." />
         </Property>
         <Property Name="kioskModeAllowColorInversionSettings" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow access to the Color Inversion Settings while in kiosk mode." />
         </Property>
         <Property Name="kioskModeAllowRingerSwitch" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the ringer switch while in kiosk mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the ringer switch while in kiosk mode. This property's functionality is redundant with the OS default and is deprecated. Use KioskModeBlockRingerSwitch instead." />
         </Property>
         <Property Name="kioskModeAllowScreenRotation" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow screen rotation while in kiosk mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow screen rotation while in kiosk mode. This property's functionality is redundant with the OS default and is deprecated. Use KioskModeBlockScreenRotation instead." />
         </Property>
         <Property Name="kioskModeAllowSleepButton" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the sleep button while in kiosk mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the sleep button while in kiosk mode. This property's functionality is redundant with the OS default and is deprecated. Use KioskModeBlockSleepButton instead." />
         </Property>
         <Property Name="kioskModeAllowTouchscreen" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the touchscreen while in kiosk mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the touchscreen while in kiosk mode. This property's functionality is redundant with the OS default and is deprecated. Use KioskModeBlockTouchscreen instead." />
         </Property>
         <Property Name="kioskModeAllowVoiceOverSettings" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow access to the voice over settings while in kiosk mode." />
         </Property>
         <Property Name="kioskModeAllowVolumeButtons" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the volume buttons while in kiosk mode." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow use of the volume buttons while in kiosk mode. This property's functionality is redundant with the OS default and is deprecated. Use KioskModeBlockVolumeButtons instead." />
         </Property>
         <Property Name="kioskModeAllowZoomSettings" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow access to the zoom settings while in kiosk mode." />
@@ -9288,16 +9392,16 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Type of passcode that is required. Possible values are: deviceDefault, alphanumeric, numeric." />
         </Property>
         <Property Name="passcodeSignInFailureCountBeforeWipe" Type="Edm.Int32">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Number of sign in failures allowed before wiping the device. Valid values 4 to 11" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Number of sign in failures allowed before wiping the device. Valid values 2 to 11" />
         </Property>
         <Property Name="podcastsBlocked" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using podcasts on the supervised device (iOS 8.0 and later)." />
         </Property>
         <Property Name="safariBlockAutofill" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using Auto fill in Safari." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using Auto fill in Safari. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="safariBlocked" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using Safari." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from using Safari. Requires a supervised device for iOS 13 and later." />
         </Property>
         <Property Name="safariBlockJavaScript" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block JavaScript in Safari." />
@@ -9468,7 +9572,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies how accounts are managed on a shared PC. Only applies when disableAccountManager is false." />
         </Property>
         <Property Name="allowedAccounts" Type="graph.sharedPCAllowedAccountType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates which type of accounts are allowed to use on a shared PC. Possible values are: guest, domain." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates which type of accounts are allowed to use on a shared PC. Possible values are: notConfigured, guest, domain." />
         </Property>
         <Property Name="allowLocalStorage" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Specifies whether local storage is allowed on a shared PC." />
@@ -9669,7 +9773,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Configures the firewall profile settings for public networks" />
         </Property>
         <Property Name="smartScreenBlockOverrideForFiles" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Allows IT Admins to control whether users can ignore SmartScreen warnings and run malicious files." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Allows IT Admins to control whether users can can ignore SmartScreen warnings and run malicious files." />
         </Property>
         <Property Name="smartScreenEnableInShell" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Allows IT Admins to configure SmartScreen for Windows." />
@@ -9808,7 +9912,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The signature update interval in hours. Specify 0 not to check. Valid values 0 to 24" />
         </Property>
         <Property Name="defenderSystemScanSchedule" Type="graph.weeklySchedule" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Defender day of the week for the system scan. Possible values are: userDefined, everyday, sunday, monday, tuesday, wednesday, thursday, friday, saturday." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Defender day of the week for the system scan. Possible values are: userDefined, everyday, sunday, monday, tuesday, wednesday, thursday, friday, saturday, noScheduledScan." />
         </Property>
         <Property Name="developerUnlockSetting" Type="graph.stateManagementSetting" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to allow developer unlock. Possible values are: notConfigured, blocked, allowed." />
@@ -10120,7 +10224,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not users can override the SmartScreen Filter warnings about downloading unverified files" />
         </Property>
         <Property Name="smartScreenEnableAppInstallControl" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Allows IT Admins to control whether users are allowed to install apps from places other than the Store." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="This property will be deprecated in July 2019 and will be replaced by property SmartScreenAppInstallControl. Allows IT Admins to control whether users are allowed to install apps from places other than the Store." />
         </Property>
         <Property Name="startBlockUnpinningAppsFromTaskbar" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether or not to block the user from unpinning apps from taskbar." />
@@ -10689,7 +10793,7 @@
       </EntityType>
       <EntityType Name="windowsUpdateForBusinessConfiguration" BaseType="graph.deviceConfiguration">
         <Property Name="automaticUpdateMode" Type="graph.automaticUpdateMode" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Automatic update mode. Possible values are: userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime, autoInstallAndRebootWithoutEndUserControl." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Automatic update mode. Possible values are: userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime, autoInstallAndRebootWithoutEndUserControl, windowsDefault." />
         </Property>
         <Property Name="businessReadyUpdatesOnly" Type="graph.windowsUpdateType" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Determines which branch devices will receive their updates from. Possible values are: userDefined, all, businessReadyOnly, windowsInsiderBuildFast, windowsInsiderBuildSlow, windowsInsiderBuildRelease." />
@@ -10730,67 +10834,67 @@
       </EntityType>
       <EntityType Name="enrollmentConfigurationAssignment" BaseType="graph.entity">
         <Property Name="target" Type="graph.deviceAndAppManagementAssignmentTarget">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents an assignment to managed devices in the tenant" />
         </Property>
       </EntityType>
       <EntityType Name="deviceEnrollmentLimitConfiguration" BaseType="graph.deviceEnrollmentConfiguration">
         <Property Name="limit" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The maximum number of devices that a user can enroll" />
         </Property>
       </EntityType>
       <EntityType Name="deviceEnrollmentPlatformRestrictionsConfiguration" BaseType="graph.deviceEnrollmentConfiguration">
         <Property Name="androidRestriction" Type="graph.deviceEnrollmentPlatformRestriction">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Android restrictions based on platform, platform operating system version, and device ownership" />
         </Property>
         <Property Name="iosRestriction" Type="graph.deviceEnrollmentPlatformRestriction">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Ios restrictions based on platform, platform operating system version, and device ownership" />
         </Property>
         <Property Name="macOSRestriction" Type="graph.deviceEnrollmentPlatformRestriction">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Mac restrictions based on platform, platform operating system version, and device ownership" />
         </Property>
         <Property Name="windowsMobileRestriction" Type="graph.deviceEnrollmentPlatformRestriction">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Windows mobile restrictions based on platform, platform operating system version, and device ownership" />
         </Property>
         <Property Name="windowsRestriction" Type="graph.deviceEnrollmentPlatformRestriction">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Windows restrictions based on platform, platform operating system version, and device ownership" />
         </Property>
       </EntityType>
       <EntityType Name="deviceEnrollmentWindowsHelloForBusinessConfiguration" BaseType="graph.deviceEnrollmentConfiguration">
         <Property Name="enhancedBiometricsState" Type="graph.enablement" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented. Possible values are: notConfigured, enabled, disabled." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the ability to use the anti-spoofing features for facial recognition on devices which support it. If set to disabled, anti-spoofing features are not allowed. If set to Not Configured, the user can choose whether they want to use anti-spoofing. Possible values are: notConfigured, enabled, disabled." />
         </Property>
         <Property Name="pinExpirationInDays" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the period of time (in days) that a PIN can be used before the system requires the user to change it. This must be set between 0 and 730, inclusive. If set to 0, the user's PIN will never expire" />
         </Property>
         <Property Name="pinLowercaseCharactersUsage" Type="graph.windowsHelloForBusinessPinUsage" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented. Possible values are: allowed, required, disallowed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the ability to use lowercase letters in the Windows Hello for Business PIN.  Allowed permits the use of lowercase letter(s), whereas Required ensures they are present. If set to Not Allowed, lowercase letters will not be permitted. Possible values are: allowed, required, disallowed." />
         </Property>
         <Property Name="pinMaximumLength" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the maximum number of characters allowed for the Windows Hello for Business PIN. This value must be between 4 and 127, inclusive. This value must be greater than or equal to the value set for the minimum PIN." />
         </Property>
         <Property Name="pinMinimumLength" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the minimum number of characters required for the Windows Hello for Business PIN.  This value must be between 4 and 127, inclusive, and less than or equal to the value set for the maximum PIN." />
         </Property>
         <Property Name="pinPreviousBlockCount" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the ability to prevent users from using past PINs. This must be set between 0 and 50, inclusive, and the current PIN of the user is included in that count. If set to 0, previous PINs are not stored. PIN history is not preserved through a PIN reset." />
         </Property>
         <Property Name="pinSpecialCharactersUsage" Type="graph.windowsHelloForBusinessPinUsage" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented. Possible values are: allowed, required, disallowed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the ability to use special characters in the Windows Hello for Business PIN.  Allowed permits the use of special character(s), whereas Required ensures they are present. If set to Not Allowed, special character(s) will not be permitted. Possible values are: allowed, required, disallowed." />
         </Property>
         <Property Name="pinUppercaseCharactersUsage" Type="graph.windowsHelloForBusinessPinUsage" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented. Possible values are: allowed, required, disallowed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the ability to use uppercase letters in the Windows Hello for Business PIN.  Allowed permits the use of uppercase letter(s), whereas Required ensures they are present. If set to Not Allowed, uppercase letters will not be permitted. Possible values are: allowed, required, disallowed." />
         </Property>
         <Property Name="remotePassportEnabled" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the use of Remote Windows Hello for Business. Remote Windows Hello for Business provides the ability for a portable, registered device to be usable as a companion for desktop authentication. The desktop must be Azure AD joined and the companion device must have a Windows Hello for Business PIN." />
         </Property>
         <Property Name="securityDeviceRequired" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls whether to require a Trusted Platform Module (TPM) for provisioning Windows Hello for Business. A TPM provides an additional security benefit in that data stored on it cannot be used on other devices. If set to False, all devices can provision Windows Hello for Business even if there is not a usable TPM." />
         </Property>
         <Property Name="state" Type="graph.enablement" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented. Possible values are: notConfigured, enabled, disabled." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls whether to allow the device to be configured for Windows Hello for Business. If set to disabled, the user cannot provision Windows Hello for Business except on Azure Active Directory joined mobile phones if otherwise required. If set to Not Configured, Intune will not override client defaults. Possible values are: notConfigured, enabled, disabled." />
         </Property>
         <Property Name="unlockWithBiometricsEnabled" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Controls the use of biometric gestures, such as face and fingerprint, as an alternative to the Windows Hello for Business PIN.  If set to False, biometric gestures are not allowed. Users must still configure a PIN as a backup in case of failures." />
         </Property>
       </EntityType>
       <EntityType Name="managedMobileApp" BaseType="graph.entity">
@@ -10841,7 +10945,7 @@
       </EntityType>
       <EntityType Name="targetedManagedAppPolicyAssignment" BaseType="graph.entity">
         <Property Name="target" Type="graph.deviceAndAppManagementAssignmentTarget">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Identifier for deployment of a group or app" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Identifier for deployment to a group or app" />
         </Property>
       </EntityType>
       <EntityType Name="windowsInformationProtectionAppLockerFile" BaseType="graph.entity">
@@ -10881,7 +10985,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Azure AD device identifier." />
         </Property>
         <Property Name="enrollmentType" Type="graph.deviceEnrollmentType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Type of the enrollment. Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Type of the enrollment. Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, appleUserEnrollment, appleUserEnrollmentWithServiceAccount, azureAdJoinUsingAzureVmExtension, androidEnterpriseDedicatedDevice, androidEnterpriseFullyManaged, androidEnterpriseCorporateWorkProfile." />
         </Property>
         <Property Name="failureCategory" Type="graph.deviceEnrollmentFailureReason" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Highlevel failure category. Possible values are: unknown, authentication, authorization, accountValidation, userValidation, deviceNotSupported, inMaintenance, badRequest, featureNotSupported, enrollmentRestrictionsEnforced, clientDisconnected, userAbandonment." />
@@ -10942,13 +11046,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Required. Title of the plan." />
         </Property>
         <NavigationProperty Name="buckets" Type="Collection(graph.plannerBucket)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable. Collection of buckets in the plan." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Collection of buckets in the plan. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="details" Type="graph.plannerPlanDetails" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable. Additional details about the plan." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Additional details about the plan. Read-only. Nullable." />
         </NavigationProperty>
         <NavigationProperty Name="tasks" Type="Collection(graph.plannerTask)" ContainsTarget="true">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Nullable. Collection of tasks in the plan." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Collection of tasks in the plan. Read-only. Nullable." />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="plannerTask" BaseType="graph.entity">
@@ -11001,7 +11105,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Plan ID to which the task belongs." />
         </Property>
         <Property Name="previewType" Type="graph.plannerPreviewType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist, description, reference." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="This sets the type of preview that shows up on the task. Possible values are: automatic, noPreview, checklist, description, reference." />
         </Property>
         <Property Name="referenceCount" Type="Edm.Int32">
           <Annotation Term="Org.OData.Core.V1.Description" String="Number of external references that exist on the task." />
@@ -11043,7 +11147,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="An object that specifies the descriptions of the six categories that can be associated with tasks in the plan" />
         </Property>
         <Property Name="sharedWith" Type="graph.plannerUserIds">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Set of user ids that this plan is shared with. If you are leveraging Microsoft 365 groups, use the Groups API to manage group membership to share the group's plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The set of user IDs that this plan is shared with. If you are using Microsoft 365 groups, use the groups API to manage group membership to share the group's plan. You can also add existing members of the group to this collection, although it is not required in order for them to access the plan owned by the group." />
         </Property>
       </EntityType>
       <EntityType Name="plannerProgressTaskBoardTaskFormat" BaseType="graph.entity">
@@ -11059,7 +11163,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Description of the task" />
         </Property>
         <Property Name="previewType" Type="graph.plannerPreviewType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist, description, reference. When set to automatic the displayed preview is chosen by the app viewing the task." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="This sets the type of preview that shows up on the task. Possible values are: automatic, noPreview, checklist, description, reference. When set to automatic the displayed preview is chosen by the app viewing the task." />
         </Property>
         <Property Name="references" Type="graph.plannerExternalReferences">
           <Annotation Term="Org.OData.Core.V1.Description" String="The collection of references on the task." />
@@ -11224,7 +11328,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The time of the last action of the operation." />
         </Property>
         <Property Name="status" Type="graph.operationStatus">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The current status of the operation: notStarted, running, completed, failed" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: notStarted, running, completed, failed. Read-only." />
         </Property>
       </EntityType>
       <EntityType Name="onenoteOperation" BaseType="graph.operation">
@@ -11378,7 +11482,9 @@
         <Property Name="fileStates" Type="Collection(graph.fileSecurityState)">
           <Annotation Term="Org.OData.Core.V1.Description" String="Security-related stateful information generated by the provider about the file(s) related to this alert." />
         </Property>
-        <Property Name="historyStates" Type="Collection(graph.alertHistoryState)" />
+        <Property Name="historyStates" Type="Collection(graph.alertHistoryState)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="A collection of alertHistoryStates comprising an audit log of all updates made to an alert." />
+        </Property>
         <Property Name="hostStates" Type="Collection(graph.hostSecurityState)">
           <Annotation Term="Org.OData.Core.V1.Description" String="Security-related stateful information generated by the provider about the host(s) related to this alert." />
         </Property>
@@ -11480,11 +11586,15 @@
         <Property Name="azureTenantId" Type="Edm.String" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="GUID string for tenant ID." />
         </Property>
-        <Property Name="complianceInformation" Type="Collection(graph.complianceInformation)" />
+        <Property Name="complianceInformation" Type="Collection(graph.complianceInformation)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The collection of compliance information associated with secure score control" />
+        </Property>
         <Property Name="controlCategory" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Control action category (Identity, Data, Device, Apps, Infrastructure)." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Control action category (Account, Data, Device, Apps, Infrastructure)." />
+        </Property>
+        <Property Name="controlStateUpdates" Type="Collection(graph.secureScoreControlStateUpdate)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Flag to indicate where the tenant has marked a control (ignore, thirdParty, reviewed) (supports update)." />
         </Property>
-        <Property Name="controlStateUpdates" Type="Collection(graph.secureScoreControlStateUpdate)" />
         <Property Name="deprecated" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Flag to indicate if a control is depreciated." />
         </Property>
@@ -11495,7 +11605,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Time at which the control profile entity was last modified. The Timestamp type represents date and time" />
         </Property>
         <Property Name="maxScore" Type="Edm.Double">
-          <Annotation Term="Org.OData.Core.V1.Description" String="max attainable score for the control." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Current obtained max score on specified date." />
         </Property>
         <Property Name="rank" Type="Edm.Int32">
           <Annotation Term="Org.OData.Core.V1.Description" String="Microsoft's stack ranking of control." />
@@ -11510,13 +11620,17 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Service that owns the control (Exchange, Sharepoint, Azure AD)." />
         </Property>
         <Property Name="threats" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="List of threats the control mitigates (accountBreach,dataDeletion,dataExfiltration,dataSpillage," />
+          <Annotation Term="Org.OData.Core.V1.Description" String="List of threats the control mitigates (accountBreach,dataDeletion,dataExfiltration,dataSpillage,elevationOfPrivilege,maliciousInsider,passwordCracking,phishingOrWhaling,spoofing)." />
+        </Property>
+        <Property Name="tier" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Control tier (Core, Defense in Depth, Advanced.)" />
         </Property>
-        <Property Name="tier" Type="Edm.String" />
         <Property Name="title" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Title of the control." />
         </Property>
-        <Property Name="userImpact" Type="Edm.String" />
+        <Property Name="userImpact" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="User impact of implementing control (low, moderate, high)." />
+        </Property>
         <Property Name="vendorInformation" Type="graph.securityVendorInformation" />
       </EntityType>
       <EntityType Name="security" BaseType="graph.entity">
@@ -11551,7 +11665,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The list of media streams." />
         </Property>
         <Property Name="recordingInfo" Type="graph.recordingInfo">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Information about whether the participant has recording capability." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Information on whether the participant has recording capability." />
         </Property>
       </EntityType>
       <EntityType Name="cancelMediaProcessingOperation" BaseType="graph.commsOperation" OpenType="true" />
@@ -11586,7 +11700,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The email address of the user." />
         </Property>
         <Property Name="userId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The guid of the user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The GUID of the user." />
         </Property>
         <NavigationProperty Name="user" Type="graph.user" />
       </EntityType>
@@ -11621,7 +11735,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with Create team. Default: false." />
         </Property>
         <Property Name="membershipType" Type="graph.channelMembershipType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The type of the channel. Can be set during creation and cannot be changed. Possible values are: standard - Channel inherits the list of members of the parent team; private - Channel can have members that are a subset of all the members on the parent team." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of the channel. Can be set during creation and cannot be changed. Default: standard." />
         </Property>
         <Property Name="webUrl" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only." />
@@ -11662,10 +11776,10 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The importance of the chat message. The possible values are: normal, high, urgent." />
         </Property>
         <Property Name="lastEditedDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Microsoft Teams UI. If no edits are made the value is null." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null." />
         </Property>
         <Property Name="lastModifiedDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read only. Timestamp when the chat message is created (initial setting) or edited, including when a reaction is added or removed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed." />
         </Property>
         <Property Name="locale" Type="Edm.String" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Locale of the chat message set by the client." />
@@ -11679,9 +11793,11 @@
         <Property Name="policyViolation" Type="graph.chatMessagePolicyViolation">
           <Annotation Term="Org.OData.Core.V1.Description" String="Defines the properties of a policy violation set by a data loss prevention (DLP) application." />
         </Property>
-        <Property Name="reactions" Type="Collection(graph.chatMessageReaction)" />
+        <Property Name="reactions" Type="Collection(graph.chatMessageReaction)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Reactions for this chat message (for example, Like)." />
+        </Property>
         <Property Name="replyToId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. Id of the parent chat message or root chat message of the thread. (Only applies to chat messages in channels not chats)" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Read-only. ID of the parent chat message or root chat message of the thread. (Only applies to chat messages in channels, not chats.)" />
         </Property>
         <Property Name="subject" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The subject of the chat message, in plaintext." />
@@ -11704,7 +11820,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Deep link URL of the tab instance. Read only." />
         </Property>
         <NavigationProperty Name="teamsApp" Type="graph.teamsApp">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The application that is linked to the tab. This cannot be changed after tab creation." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The application that is linked to the tab." />
         </NavigationProperty>
       </EntityType>
       <EntityType Name="chat" BaseType="graph.entity" />
@@ -11796,7 +11912,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The name of the app provided by the app developer." />
         </Property>
         <Property Name="teamsAppId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The ID from the Teams app manifest." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The id from the Teams App manifest." />
         </Property>
         <Property Name="version" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The version number of the application." />
@@ -11819,7 +11935,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether this workforce integration is currently active and available." />
         </Property>
         <Property Name="supportedEntities" Type="graph.workforceIntegrationSupportedEntities">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: none, shift, swapRequest, openshift, openShiftRequest, userShiftPreferences" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="This property will replace supports in v1.0. We recommend that you use this property instead of supports. The supports property will still be supported in beta for the time being. Possible values are none, shift, swapRequest, openshift, openShiftRequest, userShiftPreferences. If selecting more than one value, all values must start with the first letter in uppercase." />
         </Property>
         <Property Name="url" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Workforce Integration URL for callbacks from the Shifts service." />
@@ -11848,10 +11964,10 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Custom message sent by recipient of the offer shift request." />
         </Property>
         <Property Name="recipientUserId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="User ID of the recipient of the offer shift request." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="User id of the recipient of the offer shift request." />
         </Property>
         <Property Name="senderShiftId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="User ID of the sender of the offer shift request." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="User id of the sender of the offer shift request." />
         </Property>
       </EntityType>
       <EntityType Name="openShift" BaseType="graph.changeTrackedEntity">
@@ -11897,7 +12013,7 @@
       </EntityType>
       <EntityType Name="swapShiftsChangeRequest" BaseType="graph.offerShiftRequest">
         <Property Name="recipientShiftId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="ShiftId for the recipient user with whom the request is to swap." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Shift ID for the recipient user with whom the request is to swap." />
         </Property>
       </EntityType>
       <EntityType Name="timeOffReason" BaseType="graph.changeTrackedEntity">
@@ -12141,25 +12257,25 @@
       </ComplexType>
       <ComplexType Name="deviceDetail">
         <Property Name="browser" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the browser information of the used for signing in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the browser information of the used for signing-in." />
         </Property>
         <Property Name="deviceId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Refers to the UniqueID of the device used for signing in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Refers to the UniqueID of the device used for signing-in." />
         </Property>
         <Property Name="displayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Refers to the name of the device used for signing in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Refers to the name of the device used for signing-in." />
         </Property>
         <Property Name="isCompliant" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the device is compliant." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the device is compliant or not." />
         </Property>
         <Property Name="isManaged" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the device is managed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates if the device is managed or not." />
         </Property>
         <Property Name="operatingSystem" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the operating system name and version used for signing in." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the OS name and version used for signing-in." />
         </Property>
         <Property Name="trustType" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Provides information about whether the signed-in device is Workplace Joined, AzureAD Joined, Domain Joined." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates information on whether the signed-in device is Workplace Joined, AzureAD Joined, Domain Joined." />
         </Property>
       </ComplexType>
       <ComplexType Name="geoCoordinates">
@@ -12167,29 +12283,29 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The altitude (height), in feet,  above sea level for the item. Read-only." />
         </Property>
         <Property Name="latitude" Type="Edm.Double">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The latitude, in decimal, for the item. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The latitude, in decimal, for the item. Writable on OneDrive Personal." />
         </Property>
         <Property Name="longitude" Type="Edm.Double">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The longitude, in decimal, for the item. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The longitude, in decimal, for the item. Writable on OneDrive Personal." />
         </Property>
       </ComplexType>
       <ComplexType Name="keyValue">
         <Property Name="key" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Key for the key-value pair." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Key." />
         </Property>
         <Property Name="value" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Value for the key-value pair." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Value." />
         </Property>
       </ComplexType>
       <ComplexType Name="modifiedProperty">
         <Property Name="displayName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the property name of the target attribute that was changed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of property that was modified." />
         </Property>
         <Property Name="newValue" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the updated value for the propery." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="New property value." />
         </Property>
         <Property Name="oldValue" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the previous value (before the update) for the property." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Old property value." />
         </Property>
       </ComplexType>
       <ComplexType Name="signInLocation">
@@ -12239,10 +12355,10 @@
       </ComplexType>
       <ComplexType Name="emailAddress">
         <Property Name="address" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The email address of the person or entity." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The email address of an entity instance." />
         </Property>
         <Property Name="name" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the person or entity." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The display name of an entity instance." />
         </Property>
       </ComplexType>
       <ComplexType Name="invitedUserMessageInfo">
@@ -12303,11 +12419,21 @@
         </Property>
       </ComplexType>
       <ComplexType Name="licenseAssignmentState">
-        <Property Name="assignedByGroup" Type="Edm.String" />
-        <Property Name="disabledPlans" Type="Collection(Edm.Guid)" />
-        <Property Name="error" Type="Edm.String" />
-        <Property Name="skuId" Type="Edm.Guid" />
-        <Property Name="state" Type="Edm.String" />
+        <Property Name="assignedByGroup" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The id of the group that assigns this license. If the assignment is a direct-assigned license, this field will be Null. Read-Only." />
+        </Property>
+        <Property Name="disabledPlans" Type="Collection(Edm.Guid)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The service plans that are disabled in this assignment. Read-Only." />
+        </Property>
+        <Property Name="error" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="License assignment failure error. If the license is assigned successfully, this field will be Null. Read-Only. Possible values: CountViolation, MutuallyExclusiveViolation, DependencyViolation, ProhibitedInUsageLocationViolation, UniquenessViolation, and Others. For more information on how to identify and resolve license assignment errors see here." />
+        </Property>
+        <Property Name="skuId" Type="Edm.Guid">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier for the SKU. Read-Only." />
+        </Property>
+        <Property Name="state" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicate the current state of this assignment. Read-Only. Possible values: Active, ActiveWithError, Disabled and Error." />
+        </Property>
       </ComplexType>
       <ComplexType Name="onPremisesExtensionAttributes">
         <Property Name="extensionAttribute1" Type="Edm.String">
@@ -12372,7 +12498,7 @@
       </ComplexType>
       <ComplexType Name="passwordProfile">
         <Property Name="forceChangePasswordNextSignIn" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="true if the user must change her password on the next login; otherwise false." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="If true, at next sign-in, the user must change their password. After a password change, this property will be automatically reset to false. If not set, default is false." />
         </Property>
         <Property Name="forceChangePasswordNextSignInWithMfa" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="If true, at next sign-in, the user must perform a multi-factor authentication (MFA) before being forced to change their password. The behavior is identical to forceChangePasswordNextSignIn except that the user is required to first perform a multi-factor authentication before password change. After a password change, this property will be automatically reset to false. If not set, default is false." />
@@ -12394,7 +12520,7 @@
       </ComplexType>
       <ComplexType Name="mailboxSettings">
         <Property Name="archiveFolder" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Folder ID of an archive folder for the user." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Folder ID of an archive folder for the user. Read only." />
         </Property>
         <Property Name="automaticRepliesSetting" Type="graph.automaticRepliesSetting">
           <Annotation Term="Org.OData.Core.V1.Description" String="Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user." />
@@ -12403,7 +12529,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The date format for the user's mailbox." />
         </Property>
         <Property Name="delegateMeetingMessageDeliveryOptions" Type="graph.delegateMeetingMessageDeliveryOptions">
-          <Annotation Term="Org.OData.Core.V1.Description" String="If the user has a calendar delegate, this specifies whether the delegate, mailbox owner, or both receive meeting messages and meeting responses. Possible values are: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal, sendToDelegateOnly." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="If the user has a calendar delegate, this specifies whether the delegate, mailbox owner, or both receive meeting messages and meeting responses. Possible values are: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal, sendToDelegateOnly. The default is sendToDelegateOnly." />
         </Property>
         <Property Name="language" Type="graph.localeInfo">
           <Annotation Term="Org.OData.Core.V1.Description" String="The locale information for the user, including the preferred language and country/region." />
@@ -12420,7 +12546,7 @@
       </ComplexType>
       <ComplexType Name="automaticRepliesSetting">
         <Property Name="externalAudience" Type="graph.externalAudienceScope">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The set of audience external to the signed-in user's organization who will receive the ExternalReplyMessage, if Status is AlwaysEnabled or Scheduled. The possible values are: none, contactsOnly, all." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The set of audience external to the signed-in user's organization who will receive the ExternalReplyMessage, if Status is AlwaysEnabled or Scheduled. Possible values are: none, contactsOnly, all." />
         </Property>
         <Property Name="externalReplyMessage" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The automatic reply to send to the specified external audience, if Status is AlwaysEnabled or Scheduled." />
@@ -12435,15 +12561,15 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The date and time that automatic replies are set to begin, if Status is set to Scheduled." />
         </Property>
         <Property Name="status" Type="graph.automaticRepliesStatus">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Configurations status for automatic replies. The possible values are: disabled, alwaysEnabled, scheduled." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Configurations status for automatic replies. Possible values are: disabled, alwaysEnabled, scheduled." />
         </Property>
       </ComplexType>
       <ComplexType Name="dateTimeTimeZone">
         <Property Name="dateTime" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000)." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A single point of time in a combined date and time representation ({date}T{time}). For example, '2019-04-16T09:00:00'." />
         </Property>
         <Property Name="timeZone" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents a time zone, for example, 'Pacific Standard Time'. See below for possible values." />
         </Property>
       </ComplexType>
       <ComplexType Name="localeInfo">
@@ -12581,7 +12707,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The date and time at which the credential expires.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
         </Property>
         <Property Name="key" Type="Edm.Binary">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The certificate's raw data in byte array converted to Base64 string; for example, [System.Convert]::ToBase64String($Cert.GetRawCertData())." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Value for the key credential. Should be a base 64 encoded value." />
         </Property>
         <Property Name="keyId" Type="Edm.Guid">
           <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier (GUID) for the key." />
@@ -12674,7 +12800,9 @@
         </Property>
       </ComplexType>
       <ComplexType Name="spaApplication">
-        <Property Name="redirectUris" Type="Collection(Edm.String)" Nullable="false" />
+        <Property Name="redirectUris" Type="Collection(Edm.String)" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the URLs where user tokens are sent for sign-in, or the redirect URIs where OAuth 2.0 authorization codes and access tokens are sent." />
+        </Property>
       </ComplexType>
       <ComplexType Name="webApplication">
         <Property Name="homePageUrl" Type="Edm.String">
@@ -12805,7 +12933,7 @@
         </Property>
         <Property Name="region" Type="Edm.String" />
         <Property Name="type" Type="graph.phoneType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The type of phone number. The possible values are: home, business, mobile, other, assistant, homeFax, businessFax, otherFax, pager, radio." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of phone number. Possible values are: home, business, mobile, other, assistant, homeFax, businessFax, otherFax, pager, radio." />
         </Property>
       </ComplexType>
       <ComplexType Name="physicalOfficeAddress">
@@ -12841,7 +12969,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The object the service plan can be assigned to. Possible values:'User' - service plan can be assigned to individual users.'Company' - service plan can be assigned to the entire tenant." />
         </Property>
         <Property Name="provisioningStatus" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The provisioning status of the service plan. Possible values:'Success' - Service is fully provisioned.'Disabled' - Service has been disabled.'PendingInput' - Service is not yet provisioned; awaiting service confirmation.'PendingActivation' - Service is provisioned but requires explicit activation by administrator (for example, Intune_O365 service plan)'PendingProvisioning' - Microsoft has added a new service to the product SKU and it has not been activated in the tenant, yet." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The provisioning status of the service plan. Possible values:'Success' - Service is fully provisioned.'Disabled' - Service has been disabled.'PendingInput' - Service is not yet provisioned; awaiting service confirmation.'PendingActivation' - Service is provisioned but requires explicit activation by administrator (for example, Intune_O365 service plan).'PendingProvisioning' - Microsoft has added a new service to the product SKU and it has not been activated in the tenant, yet." />
         </Property>
         <Property Name="servicePlanId" Type="Edm.Guid">
           <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier of the service plan." />
@@ -12852,21 +12980,21 @@
       </ComplexType>
       <ComplexType Name="settingTemplateValue">
         <Property Name="defaultValue" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Default value for the setting." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Default value for the setting. Read-only." />
         </Property>
         <Property Name="description" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Description of the setting." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Description of the setting. Read-only." />
         </Property>
         <Property Name="name" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the setting." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the setting. Read-only." />
         </Property>
         <Property Name="type" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Type of the setting." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Type of the setting. Read-only." />
         </Property>
       </ComplexType>
       <ComplexType Name="settingValue">
         <Property Name="name" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the setting (as defined by the groupSettingTemplate)." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the setting (as defined by the directorySettingTemplate)." />
         </Property>
         <Property Name="value" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Value of the setting." />
@@ -12897,7 +13025,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="ID of the student in the source system." />
         </Property>
         <Property Name="gender" Type="graph.educationGender">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The possible values are: female, male, other, unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: female, male, other." />
         </Property>
         <Property Name="grade" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Current grade level of the student." />
@@ -12911,7 +13039,7 @@
       </ComplexType>
       <ComplexType Name="educationTeacher">
         <Property Name="externalId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="ID of the teacher in the source system." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Id of the Teacher in external source system." />
         </Property>
         <Property Name="teacherNumber" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Teacher number." />
@@ -12975,7 +13103,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the index of the icon in the given set." />
         </Property>
         <Property Name="set" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the set that the icon is part of. The possible values are: Invalid, ThreeArrows, ThreeArrowsGray, ThreeFlags, ThreeTrafficLights1, ThreeTrafficLights2, ThreeSigns, ThreeSymbols, ThreeSymbols2, FourArrows, FourArrowsGray, FourRedToBlack, FourRating, FourTrafficLights, FiveArrows, FiveArrowsGray, FiveRating, FiveQuarters, ThreeStars, ThreeTriangles, FiveBoxes." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the set that the icon is part of. Possible values are: Invalid, ThreeArrows, ThreeArrowsGray, ThreeFlags, ThreeTrafficLights1, ThreeTrafficLights2, ThreeSigns, ThreeSymbols, ThreeSymbols2, FourArrows, FourArrowsGray, FourRedToBlack, FourRating, FourTrafficLights, FiveArrows, FiveArrowsGray, FiveRating, FiveQuarters, ThreeStars, ThreeTriangles, FiveBoxes." />
         </Property>
       </ComplexType>
       <ComplexType Name="workbookFilterDatetime">
@@ -13010,7 +13138,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the color that is the target of the condition if the sorting is on font or cell color." />
         </Property>
         <Property Name="dataOption" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents additional sorting options for this field. The possible values are: Normal, TextAsNumber." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents additional sorting options for this field. Possible values are: Normal, TextAsNumber." />
         </Property>
         <Property Name="icon" Type="graph.workbookIcon">
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the icon that is the target of the condition if the sorting is on the cell's icon." />
@@ -13019,7 +13147,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Represents the column (or row, depending on the sort orientation) that the condition is on. Represented as an offset from the first column (or row)." />
         </Property>
         <Property Name="sortOn" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the type of sorting of this condition. The possible values are: Value, CellColor, FontColor, Icon." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the type of sorting of this condition. Possible values are: Value, CellColor, FontColor, Icon." />
         </Property>
       </ComplexType>
       <ComplexType Name="workbookWorksheetProtectionOptions">
@@ -13079,7 +13207,7 @@
       </ComplexType>
       <ComplexType Name="storagePlanInformation">
         <Property Name="upgradeAvailable" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether there are higher storage quota plans available. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates if there are higher storage quota plans available. Read-only." />
         </Property>
       </ComplexType>
       <ComplexType Name="sharepointIds">
@@ -13172,7 +13300,7 @@
       </ComplexType>
       <ComplexType Name="hashes">
         <Property Name="crc32Hash" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The CRC32 value of the file in little endian (if available). Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The CRC32 value of the file (if available). Read-only." />
         </Property>
         <Property Name="quickXorHash" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="A proprietary hash of the file that can be used to determine if the contents of the file have changed (if available). Read-only." />
@@ -13263,7 +13391,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The orientation value from the camera. Writable on OneDrive Personal." />
         </Property>
         <Property Name="takenDateTime" Type="Edm.DateTimeOffset">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the date and time the photo was taken. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The date and time the photo was taken in UTC time. Read-only." />
         </Property>
       </ComplexType>
       <ComplexType Name="publicationFacet">
@@ -13428,22 +13556,46 @@
         </Property>
       </ComplexType>
       <ComplexType Name="publicError">
-        <Property Name="code" Type="Edm.String" />
-        <Property Name="details" Type="Collection(graph.publicErrorDetail)" />
-        <Property Name="innerError" Type="graph.publicInnerError" />
-        <Property Name="message" Type="Edm.String" />
-        <Property Name="target" Type="Edm.String" />
+        <Property Name="code" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Represents the error code." />
+        </Property>
+        <Property Name="details" Type="Collection(graph.publicErrorDetail)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Details of the error." />
+        </Property>
+        <Property Name="innerError" Type="graph.publicInnerError">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Details of the inner error." />
+        </Property>
+        <Property Name="message" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="A non-localized message for the developer." />
+        </Property>
+        <Property Name="target" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The target of the error." />
+        </Property>
       </ComplexType>
       <ComplexType Name="publicErrorDetail">
-        <Property Name="code" Type="Edm.String" />
-        <Property Name="message" Type="Edm.String" />
-        <Property Name="target" Type="Edm.String" />
+        <Property Name="code" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The error code." />
+        </Property>
+        <Property Name="message" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The error message." />
+        </Property>
+        <Property Name="target" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The target of the error." />
+        </Property>
       </ComplexType>
       <ComplexType Name="publicInnerError" OpenType="true">
-        <Property Name="code" Type="Edm.String" />
-        <Property Name="details" Type="Collection(graph.publicErrorDetail)" />
-        <Property Name="message" Type="Edm.String" />
-        <Property Name="target" Type="Edm.String" />
+        <Property Name="code" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The error code." />
+        </Property>
+        <Property Name="details" Type="Collection(graph.publicErrorDetail)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="A collection of error details." />
+        </Property>
+        <Property Name="message" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The error message." />
+        </Property>
+        <Property Name="target" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The target of the error." />
+        </Property>
       </ComplexType>
       <ComplexType Name="siteCollection">
         <Property Name="dataLocationCode" Type="Edm.String">
@@ -13461,12 +13613,12 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The email address and type of attendee - whether it's a person or a resource, and whether required or optional if it's a person." />
         </Property>
         <Property Name="availability" Type="graph.freeBusyStatus">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The availability status of the attendee. The possible values are: free, tentative, busy, oof, workingElsewhere, unknown." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The availability status of the attendee. Possible values are: free, tentative, busy, oof, workingElsewhere, unknown." />
         </Property>
       </ComplexType>
       <ComplexType Name="attendeeBase" BaseType="graph.recipient">
         <Property Name="type" Type="graph.attendeeType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The type of attendee. The possible values are: required, optional, resource. Currently if the attendee is a person, findMeetingTimes always considers the person is of the Required type." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of attendee. Possible values are: required, optional, resource. Currently if the attendee is a person, findMeetingTimes always considers the person is of the Required type." />
         </Property>
       </ComplexType>
       <ComplexType Name="location">
@@ -13483,7 +13635,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Optional email address of the location." />
         </Property>
         <Property Name="locationType" Type="graph.locationType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The type of location. The possible values are: default, conferenceRoom, homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The type of location. Possible values are: default, conferenceRoom, homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress. Read-only." />
         </Property>
         <Property Name="locationUri" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Optional URI representing the location." />
@@ -13545,7 +13697,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Order of meeting time suggestions sorted by their computed confidence value from high to low, then by chronology if there are suggestions with the same confidence." />
         </Property>
         <Property Name="organizerAvailability" Type="graph.freeBusyStatus">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Availability of the meeting organizer for this meeting suggestion. The possible values are: free, tentative, busy, oof, workingElsewhere, unknown." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Availability of the meeting organizer for this meeting suggestion. Possible values are: free, tentative, busy, oof, workingElsewhere, unknown." />
         </Property>
         <Property Name="suggestionReason" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Reason for suggesting the meeting time." />
@@ -13561,7 +13713,7 @@
       </ComplexType>
       <ComplexType Name="meetingTimeSuggestionsResult">
         <Property Name="emptySuggestionsReason" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A reason for not returning any meeting suggestions. The possible values are: attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown. This property is an empty string if the meetingTimeSuggestions property does include any meeting suggestions." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A reason for not returning any meeting suggestions. Possible values are: attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown. This property is an empty string if the meetingTimeSuggestions property does include any meeting suggestions." />
         </Property>
         <Property Name="meetingTimeSuggestions" Type="Collection(graph.meetingTimeSuggestion)">
           <Annotation Term="Org.OData.Core.V1.Description" String="An array of meeting suggestions." />
@@ -13569,7 +13721,7 @@
       </ComplexType>
       <ComplexType Name="timeConstraint">
         <Property Name="activityDomain" Type="graph.activityDomain">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The nature of the activity, optional. The possible values are: work, personal, unrestricted, or unknown." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The nature of the activity, optional. Possible values are: work, personal, unrestricted, or unknown." />
         </Property>
         <Property Name="timeSlots" Type="Collection(graph.timeSlot)" />
       </ComplexType>
@@ -13600,7 +13752,7 @@
       </ComplexType>
       <ComplexType Name="responseStatus">
         <Property Name="response" Type="graph.responseType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The response type. The possible values are: None, Organizer, TentativelyAccepted, Accepted, Declined, NotResponded." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The response type. Possible values are: None, Organizer, TentativelyAccepted, Accepted, Declined, NotResponded." />
         </Property>
         <Property Name="time" Type="Edm.DateTimeOffset">
           <Annotation Term="Org.OData.Core.V1.Description" String="The date and time that the response was returned. It uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
@@ -13790,7 +13942,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether a message should be permanently deleted and not saved to the Deleted Items folder." />
         </Property>
         <Property Name="redirectTo" Type="Collection(graph.recipient)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The email addresses to which a message should be redirected." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The email address to which a message should be redirected." />
         </Property>
         <Property Name="stopProcessingRules" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether subsequent rules should be evaluated." />
@@ -13929,13 +14081,13 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The day of the month on which the event occurs. Required if type is absoluteMonthly or absoluteYearly." />
         </Property>
         <Property Name="daysOfWeek" Type="Collection(graph.dayOfWeek)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A collection of the days of the week on which the event occurs. The possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. If type is relativeMonthly or relativeYearly, and daysOfWeek specifies more than one day, the event falls on the first day that satisfies the pattern.  Required if type is weekly, relativeMonthly, or relativeYearly." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="A collection of the days of the week on which the event occurs. Possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. If type is relativeMonthly or relativeYearly, and daysOfWeek specifies more than one day, the event falls on the first day that satisfies the pattern.  Required if type is weekly, relativeMonthly, or relativeYearly." />
         </Property>
         <Property Name="firstDayOfWeek" Type="graph.dayOfWeek">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The first day of the week. The possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. Default is sunday. Required if type is weekly." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The first day of the week. Possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. Default is sunday. Required if type is weekly." />
         </Property>
         <Property Name="index" Type="graph.weekIndex">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies on which instance of the allowed days specified in daysOfsWeek the event occurs, counted from the first instance in the month. The possible values are: first, second, third, fourth, last. Default is first. Optional and used if type is relativeMonthly or relativeYearly." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies on which instance of the allowed days specified in daysOfsWeek the event occurs, counted from the first instance in the month. Possible values are: first, second, third, fourth, last. Default is first. Optional and used if type is relativeMonthly or relativeYearly." />
         </Property>
         <Property Name="interval" Type="Edm.Int32" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The number of units between occurrences, where units can be in days, weeks, months, or years, depending on the type. Required." />
@@ -13961,7 +14113,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The date to start applying the recurrence pattern. The first occurrence of the meeting may be this date or later, depending on the recurrence pattern of the event. Must be the same value as the start property of the recurring event. Required." />
         </Property>
         <Property Name="type" Type="graph.recurrenceRangeType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The recurrence range. The possible values are: endDate, noEnd, numbered. Required." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The recurrence range. Possible values are: endDate, noEnd, numbered. Required." />
         </Property>
       </ComplexType>
       <ComplexType Name="personType">
@@ -14058,7 +14210,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The date and time in UTC that the upload session will expire. The complete file must be uploaded before this expiration time is reached." />
         </Property>
         <Property Name="nextExpectedRanges" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format 'start-end' (e.g. '0-26' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value '{start}', the location in the file where the next upload should begin." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="When uploading files to document libraries, this is a collection of byte ranges that the server is missing for the file. These ranges are zero-indexed and of the format, '{start}-{end}' (e.g. '0-26' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value '{start}', the location in the file where the next upload should begin." />
         </Property>
         <Property Name="uploadUrl" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The URL endpoint that accepts PUT requests for byte ranges of the file." />
@@ -14072,7 +14224,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The display name of the web site." />
         </Property>
         <Property Name="type" Type="graph.websiteType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The possible values are: other, home, work, blog, profile." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: other, home, work, blog, profile." />
         </Property>
       </ComplexType>
       <ComplexType Name="accessAction" OpenType="true" />
@@ -14294,7 +14446,7 @@
       </ComplexType>
       <ComplexType Name="extensionSchemaProperty">
         <Property Name="name" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The name of the strongly-typed property defined as part of a schema extension." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The name of the strongly typed property defined as part of a schema extension." />
         </Property>
         <Property Name="type" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The type of the property that is defined as part of a schema extension.  Allowed values are Binary, Boolean, DateTime, Integer or String.  See the table below for more details." />
@@ -14308,7 +14460,7 @@
       <ComplexType Name="applicationEnforcedRestrictionsSessionControl" BaseType="graph.conditionalAccessSessionControl" />
       <ComplexType Name="cloudAppSecuritySessionControl" BaseType="graph.conditionalAccessSessionControl">
         <Property Name="cloudAppSecurityType" Type="graph.cloudAppSecuritySessionControlType">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: mcasConfigured, monitorOnly, blockDownloads, unknownFutureValue. For more information, see Deploy Conditional Access App Control for featured apps." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: mcasConfigured, monitorOnly, blockDownloads. Learn more about these values here: https://docs.microsoft.com/cloud-app-security/proxy-deployment-aad#step-1-create-an-azure-ad-conditional-access-test-policy-" />
         </Property>
       </ComplexType>
       <ComplexType Name="conditionalAccessApplications">
@@ -14319,7 +14471,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The list of application IDs the policy applies to, unless explicitly excluded (in excludeApplications). Can also be set to All." />
         </Property>
         <Property Name="includeUserActions" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="User actions to include. For example, urn:user:registersecurityinfo" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="User actions to include. Supported values are urn:user:registersecurityinfo and urn:user:registerdevice" />
         </Property>
       </ComplexType>
       <ComplexType Name="conditionalAccessConditionSet">
@@ -14339,7 +14491,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Sign-in risk levels included in the policy. Possible values are: low, medium, high, none." />
         </Property>
         <Property Name="userRiskLevels" Type="Collection(graph.riskLevel)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="User risk levels included in the policy. Possible values are: low, medium, high." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="User risk levels included in the policy. Possible values are: low, medium, high, none." />
         </Property>
         <Property Name="users" Type="graph.conditionalAccessUsers" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Users, groups, and roles included in and excluded from the policy. Required." />
@@ -14355,10 +14507,10 @@
       </ComplexType>
       <ComplexType Name="conditionalAccessPlatforms">
         <Property Name="excludePlatforms" Type="Collection(graph.conditionalAccessDevicePlatform)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: android, iOS, windows, windowsPhone, macOS, unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: android, iOS, windows, windowsPhone, macOS." />
         </Property>
         <Property Name="includePlatforms" Type="Collection(graph.conditionalAccessDevicePlatform)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: android, iOS, windows, windowsPhone, macOS, all, unknownFutureValue." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: android, iOS, windows, windowsPhone, macOS, all." />
         </Property>
       </ComplexType>
       <ComplexType Name="conditionalAccessUsers">
@@ -14386,7 +14538,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="List of values of built-in controls required by the policy. Possible values: block, mfa, compliantDevice, domainJoinedDevice, approvedApplication, compliantApplication, passwordChange." />
         </Property>
         <Property Name="customAuthenticationFactors" Type="Collection(Edm.String)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="List of custom controls IDs required by the policy. For more information, see Custom controls." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="List of custom controls IDs required by the policy. Learn more about custom controls here: https://docs.microsoft.com/azure/active-directory/conditional-access/controls#custom-controls-preview" />
         </Property>
         <Property Name="operator" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Defines the relationship of the grant controls. Possible values: AND, OR." />
@@ -14499,7 +14651,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The key used to get mac." />
         </Property>
         <Property Name="profileIdentifier" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The profile identifier." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The the profile identifier." />
         </Property>
       </ComplexType>
       <ComplexType Name="iosDeviceType">
@@ -14619,7 +14771,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The file or folder name to look up." />
         </Property>
         <Property Name="operationType" Type="graph.win32LobAppFileSystemOperationType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The file system operation type. Possible values are: notConfigured, exists, modifiedDate, createdDate, version, sizeInMB." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The file system operation type. Possible values are: notConfigured, exists, modifiedDate, createdDate, version, sizeInMB, doesNotExist." />
         </Property>
         <Property Name="operator" Type="graph.win32LobAppRuleOperator" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The operator for file or folder detection. Possible values are: notConfigured, equal, notEqual, greaterThan, greaterThanOrEqual, lessThan, lessThanOrEqual." />
@@ -14632,7 +14784,9 @@
         <Property Name="deviceRestartBehavior" Type="graph.win32LobAppRestartBehavior" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Device restart behavior. Possible values are: basedOnReturnCode, allow, suppress, force." />
         </Property>
-        <Property Name="runAsAccount" Type="graph.runAsAccountType" Nullable="false" />
+        <Property Name="runAsAccount" Type="graph.runAsAccountType" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type of execution context the app runs in. Possible values are: system, user." />
+        </Property>
       </ComplexType>
       <ComplexType Name="win32LobAppMsiInformation">
         <Property Name="packageType" Type="graph.win32LobAppMsiPackageType" Nullable="false">
@@ -14676,7 +14830,9 @@
         <Property Name="runAs32Bit" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="A value indicating whether the script should run as 32-bit." />
         </Property>
-        <Property Name="runAsAccount" Type="graph.runAsAccountType" />
+        <Property Name="runAsAccount" Type="graph.runAsAccountType">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The execution context of the script. Do not specify this value if the rule is used for detection. Script detection rules will run in the same context as the associated app install context. Possible values are: system, user." />
+        </Property>
         <Property Name="scriptContent" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The base64-encoded script content." />
         </Property>
@@ -14733,7 +14889,7 @@
       </ComplexType>
       <ComplexType Name="deviceManagementSettings">
         <Property Name="deviceComplianceCheckinThresholdDays" Type="Edm.Int32" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The number of days a device is allowed to go without checking in to remain compliant. Valid values 0 to 120" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The number of days a device is allowed to go without checking in to remain compliant." />
         </Property>
         <Property Name="isScheduledActionEnabled" Type="Edm.Boolean" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Is feature enabled or not for scheduled action for rule." />
@@ -15128,7 +15284,7 @@
       </ComplexType>
       <ComplexType Name="report">
         <Property Name="content" Type="Edm.Stream">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not yet documented" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Report content; details vary by report type." />
         </Property>
       </ComplexType>
       <ComplexType Name="sharedPCAccountManagerPolicy">
@@ -15147,7 +15303,7 @@
       </ComplexType>
       <ComplexType Name="windows10NetworkProxyServer">
         <Property Name="address" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Address to the proxy server. Specify an address in the format &lt;server&gt;[:&lt;port&gt;]" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Address to the proxy server. Specify an address in the format [':']" />
         </Property>
         <Property Name="exceptions" Type="Collection(Edm.String)">
           <Annotation Term="Org.OData.Core.V1.Description" String="Addresses that should not use the proxy server. The system will not use the proxy server for addresses beginning with what is specified in this node." />
@@ -15205,7 +15361,7 @@
       </ComplexType>
       <ComplexType Name="windowsUpdateScheduledInstall" BaseType="graph.windowsUpdateInstallScheduleType">
         <Property Name="scheduledInstallDay" Type="graph.weeklySchedule" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Scheduled Install Day in week. Possible values are: userDefined, everyday, sunday, monday, tuesday, wednesday, thursday, friday, saturday." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Scheduled Install Day in week. Possible values are: userDefined, everyday, sunday, monday, tuesday, wednesday, thursday, friday, saturday, noScheduledScan." />
         </Property>
         <Property Name="scheduledInstallTime" Type="Edm.TimeOfDay" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Scheduled Install Time during day" />
@@ -15509,10 +15665,10 @@
       </ComplexType>
       <ComplexType Name="iPv6Range" BaseType="graph.ipRange">
         <Property Name="lowerAddress" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Lower address" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Lower address." />
         </Property>
         <Property Name="upperAddress" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Upper address" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Upper address." />
         </Property>
       </ComplexType>
       <ComplexType Name="keyValuePair">
@@ -15597,7 +15753,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Display name" />
         </Property>
         <Property Name="ranges" Type="Collection(graph.ipRange)" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Collection of Internet protocol address ranges" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Collection of ip ranges" />
         </Property>
       </ComplexType>
       <ComplexType Name="windowsInformationProtectionProxiedDomainCollection">
@@ -15622,12 +15778,12 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Allowed Actions" />
         </Property>
         <Property Name="notAllowedResourceActions" Type="Collection(Edm.String)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Not Allowed Actions" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Not Allowed Actions." />
         </Property>
       </ComplexType>
       <ComplexType Name="rolePermission">
         <Property Name="resourceActions" Type="Collection(graph.resourceAction)">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Actions" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Resource Actions each containing a set of allowed and not allowed permissions." />
         </Property>
       </ComplexType>
       <ComplexType Name="searchHit">
@@ -15662,13 +15818,27 @@
         </Property>
       </ComplexType>
       <ComplexType Name="searchRequest">
-        <Property Name="contentSources" Type="Collection(Edm.String)" />
-        <Property Name="enableTopResults" Type="Edm.Boolean" />
-        <Property Name="entityTypes" Type="Collection(graph.entityType)" />
-        <Property Name="fields" Type="Collection(Edm.String)" />
-        <Property Name="from" Type="Edm.Int32" Nullable="false" />
-        <Property Name="query" Type="graph.searchQuery" Nullable="false" />
-        <Property Name="size" Type="Edm.Int32" Nullable="false" />
+        <Property Name="contentSources" Type="Collection(Edm.String)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the connection to be targeted. Respects the following format : /external/connections/connectionid where connectionid is the ConnectionId defined in the Connectors Administration.  Note : contentSource is only applicable when entityType=externalItem. Optional." />
+        </Property>
+        <Property Name="enableTopResults" Type="Edm.Boolean">
+          <Annotation Term="Org.OData.Core.V1.Description" String="This triggers hybrid sort for messages : the first 3 messages are the most relevant. This property is only applicable to entityType=message. Optional." />
+        </Property>
+        <Property Name="entityTypes" Type="Collection(graph.entityType)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="One or more types of resources expected in the response. Possible values are: list, site, listItem, message, event, drive, driveItem, externalItem. See known limitations for those combinations of two or more entity types that are supported in the same search request. Required." />
+        </Property>
+        <Property Name="fields" Type="Collection(Edm.String)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the fields to be returned for each resource object specified in entityTypes, allowing customization of the fields returned by default otherwise, including additional fields such as custom managed properties from SharePoint and OneDrive, or custom fields in externalItem from content ingested by Graph connectors. Optional." />
+        </Property>
+        <Property Name="from" Type="Edm.Int32" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the offset for the search results. Offset 0 returns the very first result. Optional." />
+        </Property>
+        <Property Name="query" Type="graph.searchQuery" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Contains the query terms. Required." />
+        </Property>
+        <Property Name="size" Type="Edm.Int32" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The size of the page to be retrieved. Optional." />
+        </Property>
       </ComplexType>
       <ComplexType Name="searchResponse">
         <Property Name="hitsContainers" Type="Collection(graph.searchHitsContainer)">
@@ -15851,8 +16021,12 @@
         </Property>
       </ComplexType>
       <ComplexType Name="diagnostic">
-        <Property Name="message" Type="Edm.String" />
-        <Property Name="url" Type="Edm.String" />
+        <Property Name="message" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The message describing the condition that triggered the error or warning." />
+        </Property>
+        <Property Name="url" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The link to the documentation for this issue." />
+        </Property>
       </ComplexType>
       <ComplexType Name="onenoteOperationError">
         <Property Name="code" Type="Edm.String">
@@ -15871,16 +16045,16 @@
       </ComplexType>
       <ComplexType Name="onenotePatchContentCommand">
         <Property Name="action" Type="graph.onenotePatchActionType" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The action to perform on the target element. The possible values are: replace, append, delete, insert, or prepend." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The action to perform on the target element. Possible values are: replace, append, delete, insert, or prepend." />
         </Property>
         <Property Name="content" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="A string of well-formed HTML to add to the page, and any image or file binary data. If the content contains binary data, the request must be sent using the multipart/form-data content type with a 'Commands' part." />
         </Property>
         <Property Name="position" Type="graph.onenotePatchInsertPosition">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The location to add the supplied content, relative to the target element. The possible values are: after (default) or before." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The location to add the supplied content, relative to the target element. Possible values are: after (default) or before." />
         </Property>
         <Property Name="target" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The element to update. Must be the #&lt;data-id&gt; or the generated &lt;id&gt; of the element, or the body or title keyword." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The element to update. Must be the #&lt;data-id&gt; or the generated {id} of the element, or the body or title keyword." />
         </Property>
       </ComplexType>
       <ComplexType Name="pageLinks">
@@ -15907,7 +16081,7 @@
       </ComplexType>
       <ComplexType Name="recentNotebookLinks">
         <Property Name="oneNoteClientUrl" Type="graph.externalLink">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Opens the notebook in the OneNote native client if it's installed." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Opens the notebook in the OneNote client, if it's installed." />
         </Property>
         <Property Name="oneNoteWebUrl" Type="graph.externalLink">
           <Annotation Term="Org.OData.Core.V1.Description" String="Opens the notebook in OneNote on the web." />
@@ -15956,13 +16130,27 @@
         <Property Name="name" Type="Edm.String" />
       </ComplexType>
       <ComplexType Name="alertHistoryState">
-        <Property Name="appId" Type="Edm.String" />
-        <Property Name="assignedTo" Type="Edm.String" />
-        <Property Name="comments" Type="Collection(Edm.String)" />
-        <Property Name="feedback" Type="graph.alertFeedback" />
-        <Property Name="status" Type="graph.alertStatus" />
-        <Property Name="updatedDateTime" Type="Edm.DateTimeOffset" />
-        <Property Name="user" Type="Edm.String" />
+        <Property Name="appId" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Application ID of the calling application that submitted an update (PATCH) to the alert. The appId should be extracted from the auth token and not entered manually by the calling application." />
+        </Property>
+        <Property Name="assignedTo" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="UPN of user the alert was assigned to (note: alert.assignedTo only stores the last value/UPN)." />
+        </Property>
+        <Property Name="comments" Type="Collection(Edm.String)">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Comment entered by signed-in user." />
+        </Property>
+        <Property Name="feedback" Type="graph.alertFeedback">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Analyst feedback on the alert in this update. Possible values are: unknown, truePositive, falsePositive, benignPositive." />
+        </Property>
+        <Property Name="status" Type="graph.alertStatus">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Alert status value (if updated). Possible values are: unknown, newAlert, inProgress, resolved, dismissed." />
+        </Property>
+        <Property Name="updatedDateTime" Type="Edm.DateTimeOffset">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Date and time of the alert update. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
+        </Property>
+        <Property Name="user" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="UPN of the signed-in user that updated the alert (taken from the bearer token - if in user/delegated auth mode)." />
+        </Property>
       </ComplexType>
       <ComplexType Name="alertTrigger">
         <Property Name="name" Type="Edm.String">
@@ -16105,7 +16293,7 @@
       </ComplexType>
       <ComplexType Name="networkConnection">
         <Property Name="applicationName" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the application managing the network connection (for example, Facebook or SMTP)." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Name of the application managing the network connection (for example, Facebook, SMTP, etc.)." />
         </Property>
         <Property Name="destinationAddress" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="Destination IP address (of the network connection)." />
@@ -16236,11 +16424,21 @@
         </Property>
       </ComplexType>
       <ComplexType Name="secureScoreControlStateUpdate">
-        <Property Name="assignedTo" Type="Edm.String" />
-        <Property Name="comment" Type="Edm.String" />
-        <Property Name="state" Type="Edm.String" />
-        <Property Name="updatedBy" Type="Edm.String" />
-        <Property Name="updatedDateTime" Type="Edm.DateTimeOffset" />
+        <Property Name="assignedTo" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Assigns the control to the user who will take the action." />
+        </Property>
+        <Property Name="comment" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Provides optional comment about the control." />
+        </Property>
+        <Property Name="state" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="State of the control, which can be modified via a PATCH command (for example, ignored, thirdParty)." />
+        </Property>
+        <Property Name="updatedBy" Type="Edm.String">
+          <Annotation Term="Org.OData.Core.V1.Description" String="ID of the user who updated tenant state." />
+        </Property>
+        <Property Name="updatedDateTime" Type="Edm.DateTimeOffset">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Time at which the control state was updated." />
+        </Property>
       </ComplexType>
       <ComplexType Name="securityResource">
         <Property Name="resource" Type="Edm.String">
@@ -16372,7 +16570,7 @@
       </ComplexType>
       <ComplexType Name="chatInfo">
         <Property Name="messageId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier of a message in a Microsoft Teams channel." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The unique identifier for a message in a Microsoft Teams channel." />
         </Property>
         <Property Name="replyChainMessageId" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="The ID of the reply message." />
@@ -16396,13 +16594,13 @@
       </ComplexType>
       <ComplexType Name="incomingContext">
         <Property Name="observedParticipantId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The ID of the participant that is under observation. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The id of the participant that is under observation. Read-only." />
         </Property>
         <Property Name="onBehalfOf" Type="graph.identitySet">
           <Annotation Term="Org.OData.Core.V1.Description" String="The identity that the call is happening on behalf of." />
         </Property>
         <Property Name="sourceParticipantId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The ID of the participant that triggered the incoming call. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The id of the participant that triggered the incoming call. Read-only." />
         </Property>
         <Property Name="transferor" Type="graph.identitySet">
           <Annotation Term="Org.OData.Core.V1.Description" String="The identity that transferred the call." />
@@ -16413,7 +16611,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The identitySet associated with this invitation." />
         </Property>
         <Property Name="replacesCallId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The call which the target identity is currently a part of. This call will be dropped once the participant is added." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. The call which the target idenity is currently a part of. This call will be dropped once the participant is added." />
         </Property>
       </ComplexType>
       <ComplexType Name="lobbyBypassSettings">
@@ -16426,16 +16624,16 @@
       </ComplexType>
       <ComplexType Name="mediaInfo">
         <Property Name="resourceId" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Optional. Used to uniquely identity the resource. If passed in, the prompt uri will be cached against this resourceId as a key." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Optional, used to uniquely identity the resource. If passed the prompt uri will be cached against this resourceId as key." />
         </Property>
         <Property Name="uri" Type="Edm.String" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Path to the prompt that will be played. Currently supports only Wave file (.wav) format, single-channel, 16-bit samples with a 16,000 (16KHz) sampling rate." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Path to the prompt to be played. Currently only Wave file (.wav) format, single-channel, 16-bit samples with a 16,000 (16KHz) sampling rate is only supported." />
         </Property>
       </ComplexType>
       <ComplexType Name="prompt" Abstract="true" />
       <ComplexType Name="mediaPrompt" BaseType="graph.prompt">
         <Property Name="mediaInfo" Type="graph.mediaInfo" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The media information" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The media information." />
         </Property>
       </ComplexType>
       <ComplexType Name="mediaStream">
@@ -16449,7 +16647,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The media type. The possible value are unknown, audio, video, videoBasedScreenSharing, data." />
         </Property>
         <Property Name="serverMuted" Type="Edm.Boolean" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="If the media is muted by the server." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Indicates whether the media is muted by the server." />
         </Property>
         <Property Name="sourceId" Type="Edm.String" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="The source ID." />
@@ -16461,7 +16659,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Identity information of the participant." />
         </Property>
         <Property Name="role" Type="graph.onlineMeetingRole">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the participant's role in the meeting.  Possible values are listed in the following table." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Specifies the participant's role in the meeting.  Possible values are attendee, presenter, and unknownFutureValue." />
         </Property>
         <Property Name="upn" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="User principal name of the participant." />
@@ -16491,12 +16689,12 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The language culture string. Read-only." />
         </Property>
         <Property Name="region" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The home region of the participant. This can be a country, a continent, or a larger geographic region. This does not change based on the participant's current physical location. Read-only." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The home region of the participant. This can be a country, a continent, or a larger geographic region. This does not change based on the participant's current physical location, unlike countryCode. Read-only." />
         </Property>
       </ComplexType>
       <ComplexType Name="recordingInfo">
         <Property Name="initiator" Type="graph.identitySet">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The identities of the recording initiator." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The identities of recording initiator." />
         </Property>
         <Property Name="recordingStatus" Type="graph.recordingStatus" Nullable="false">
           <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: unknown, notRecording, recording, or failed." />
@@ -16641,7 +16839,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="An incremental identifier used for ordering DTMF events." />
         </Property>
         <Property Name="tone" Type="graph.tone" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: tone0, tone1, tone2, tone3, tone4, tone5, tone6, tone7, tone8, tone9, star, pound" />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Possible values are: tone0, tone1, tone2, tone3, tone4, tone5, tone6, tone7, tone8, tone9, star, pound, a, b, c, d, flash." />
         </Property>
       </ComplexType>
       <ComplexType Name="changeNotification">
@@ -16649,7 +16847,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type of change that will raise the change notification. The supported values are: created, updated, deleted. Required." />
         </Property>
         <Property Name="clientState" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Value of the clientState property sent in the subscription request (if any). The maximum length is 255 characters. The client can check whether the change notification came from the service by comparing the values of the clientState property. The value of the clientState property sent with the subscription is compared with the value of the clientState property received with each change notification. Optional." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Value of the clientState property sent specified in the subscription request (if any). The maximum length is 255 characters. The client can check whether the change notification came from the service by comparing the values of the clientState property. The value of the clientState property sent with the subscription is compared with the value of the clientState property received with each change notification. Optional." />
         </Property>
         <Property Name="encryptedContent" Type="graph.changeNotificationEncryptedContent">
           <Annotation Term="Org.OData.Core.V1.Description" String="(Preview) Encrypted content attached with the change notification. Only provided if encryptionCertificate and includeResourceData were defined during the subscription request and if the resource supports it. Optional." />
@@ -16707,7 +16905,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="The content of the attachment. If the attachment is a rich card, set the property to the rich card object. This property and contentUrl are mutually exclusive." />
         </Property>
         <Property Name="contentType" Type="Edm.String">
-          <Annotation Term="Org.OData.Core.V1.Description" String="The media type of the content attachment. It can have the following values: reference: Attachment is a link to another file. Populate the contentURL with the link to the object.file: Raw file attachment. Populate the contenturl field with the base64 encoding of the file in data: format.image/: Image type with the type of the image specified ex: image/png, image/jpeg, image/gif. Populate the contentUrl field with the base64 encoding of the file in data: format.video/: Video type with the format specified. Ex: video/mp4. Populate the contentUrl field with the base64 encoding of the file in data: format.audio/: Audio type with the format specified. Ex: audio/wmw. Populate the contentUrl field with the base64 encoding of the file in data: format.application/card type: Rich card attachment type with the card type specifying the exact card format to use. Set content with the json format of the card. Supported values for card type include:application/vnd.microsoft.card.adaptive: A rich card that can contain any combination of text, speech, images,,buttons, and input fields. Set the content property to,an AdaptiveCard object.application/vnd.microsoft.card.animation: A rich card that plays animation. Set the content property,to an AnimationCardobject.application/vnd.microsoft.card.audio: A rich card that plays audio files. Set the content property,to an AudioCard object.application/vnd.microsoft.card.video: A rich card that plays videos. Set the content property,to a VideoCard object.application/vnd.microsoft.card.hero: A Hero card. Set the content property to a HeroCard object.application/vnd.microsoft.card.thumbnail: A Thumbnail card. Set the content property to a ThumbnailCard object.application/vnd.microsoft.com.card.receipt: A Receipt card. Set the content property to a ReceiptCard object.application/vnd.microsoft.com.card.signin: A user Sign In card. Set the content property to a SignInCard object." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="The media type of the content attachment. It can have the following values: reference: Attachment is a link to another file. Populate the contentURL with the link to the object.Any contentTypes supported by the Bot Framework's Attachment objectapplication/vnd.microsoft.card.codesnippet: A code snippet. application/vnd.microsoft.card.announcement: An announcement header." />
         </Property>
         <Property Name="contentUrl" Type="Edm.String">
           <Annotation Term="Org.OData.Core.V1.Description" String="URL for the content of the attachment. Supported protocols: http, https, file and data." />
@@ -16762,9 +16960,15 @@
         </Property>
       </ComplexType>
       <ComplexType Name="chatMessageReaction">
-        <Property Name="createdDateTime" Type="Edm.DateTimeOffset" Nullable="false" />
-        <Property Name="reactionType" Type="Edm.String" Nullable="false" />
-        <Property Name="user" Type="graph.identitySet" Nullable="false" />
+        <Property Name="createdDateTime" Type="Edm.DateTimeOffset" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'" />
+        </Property>
+        <Property Name="reactionType" Type="Edm.String" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="Supported values are like, angry, sad, laugh, heart, surprised." />
+        </Property>
+        <Property Name="user" Type="graph.identitySet" Nullable="false">
+          <Annotation Term="Org.OData.Core.V1.Description" String="The user who reacted to the message." />
+        </Property>
       </ComplexType>
       <ComplexType Name="operationError">
         <Property Name="code" Type="Edm.String">
@@ -16809,7 +17013,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="If set to true, members can add and update private channels." />
         </Property>
         <Property Name="allowCreateUpdateChannels" Type="Edm.Boolean">
-          <Annotation Term="Org.OData.Core.V1.Description" String="If set to true, members can add and update channels." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="If set to true, members can add and update any channels." />
         </Property>
         <Property Name="allowCreateUpdateRemoveConnectors" Type="Edm.Boolean">
           <Annotation Term="Org.OData.Core.V1.Description" String="If set to true, members can add, update, and remove connectors." />
@@ -21044,8 +21248,8 @@
       </Action>
       <Action Name="accept" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
         <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
+        <Parameter Name="SendResponse" Type="Edm.Boolean" />
       </Action>
       <Action Name="cancel" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
@@ -21053,9 +21257,8 @@
       </Action>
       <Action Name="decline" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="ProposedNewTime" Type="graph.timeSlot" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
         <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
+        <Parameter Name="SendResponse" Type="Edm.Boolean" />
       </Action>
       <Action Name="decline" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.scheduleChangeRequest" />
@@ -21086,9 +21289,8 @@
       </Action>
       <Action Name="tentativelyAccept" IsBound="true">
         <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="ProposedNewTime" Type="graph.timeSlot" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
         <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
+        <Parameter Name="SendResponse" Type="Edm.Boolean" />
       </Action>
       <Action Name="copy" IsBound="true" EntitySetPath="bindingParameter">
         <Parameter Name="bindingParameter" Type="graph.mailFolder" />
@@ -21577,27 +21779,19 @@
         <Parameter Name="startDateTime" Type="Edm.DateTimeOffset" />
         <Parameter Name="endDateTime" Type="Edm.DateTimeOffset" />
       </Action>
-      <Action Name="accept" IsBound="true">
-        <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
-      </Action>
-      <Action Name="decline" IsBound="true">
-        <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
-      </Action>
-      <Action Name="tentativelyAccept" IsBound="true">
-        <Parameter Name="bindingParameter" Type="graph.event" />
-        <Parameter Name="Comment" Type="Edm.String" Unicode="false" />
-        <Parameter Name="SendResponse" Type="Edm.Boolean" />
-      </Action>
       <Term Name="changed" Type="Edm.Boolean" AppliesTo="microsoft.graph.driveItem" />
       <Term Name="conflictBehavior" Type="Edm.String" AppliesTo="microsoft.graph.driveItem" />
       <Term Name="downloadUrl" Type="Edm.String" AppliesTo="microsoft.graph.driveItem" />
       <Term Name="sharedChanged" Type="Edm.Boolean" AppliesTo="microsoft.graph.driveItem" />
       <Term Name="sourceUrl" Type="Edm.String" AppliesTo="microsoft.graph.driveItem" />
       <Term Name="conflictBehavior" Type="Edm.String" AppliesTo="microsoft.graph.driveItemUploadableProperties" />
+      <Term Name="conflictBehavior" Type="Edm.String" AppliesTo="microsoft.graph.driveItemUploadableProperties" />
+      <Term Name="channelCreationMode" Type="Edm.String" AppliesTo="microsoft.graph.channel">
+        <Annotation Term="Org.OData.Core.V1.LongDescription" String="Indicates that the channel is in migration state and is currently being used for migration purposes. It accepts one value: migration." />
+      </Term>
+      <Term Name="temporaryId" Type="Edm.String" AppliesTo="microsoft.graph.chatMessageHostedContent">
+        <Annotation Term="Org.OData.Core.V1.LongDescription" String="Write-only. Represents the temporaryId for the hosted content while posting a message to refer to the hosted content in chatMessage resource being sent." />
+      </Term>
       <Term Name="conflictBehavior" Type="Edm.String" AppliesTo="microsoft.graph.driveItem">
         <Annotation Term="Org.OData.Core.V1.LongDescription" String="The conflict resolution behavior for actions that create a new item. You can use the values fail, replace, or rename. The default for PUT is replace. An item will never be returned with this annotation. Write-only." />
       </Term>
@@ -21607,6 +21801,18 @@
       <Term Name="sourceUrl" Type="Edm.String" AppliesTo="microsoft.graph.driveItem">
         <Annotation Term="Org.OData.Core.V1.LongDescription" String="When issuing a PUT request, this instance annotation can be used to instruct the service to download the contents of the URL, and store it as the file. Write-only." />
       </Term>
+      <Term Name="conflictBehavior" Type="Edm.String" AppliesTo="microsoft.graph.driveItem">
+        <Annotation Term="Org.OData.Core.V1.LongDescription" String="The conflict resolution behavior for actions that create a new item. You can use the values fail, replace, or rename. The default for PUT is replace. An item will never be returned with this annotation. Write-only." />
+      </Term>
+      <Term Name="downloadUrl" Type="Edm.String" AppliesTo="microsoft.graph.driveItem">
+        <Annotation Term="Org.OData.Core.V1.LongDescription" String="A URL that can be used to download this file's content. Authentication is not required with this URL. Read-only." />
+      </Term>
+      <Term Name="sourceUrl" Type="Edm.String" AppliesTo="microsoft.graph.driveItem">
+        <Annotation Term="Org.OData.Core.V1.LongDescription" String="When issuing a PUT request, this instance annotation can be used to instruct the service to download the contents of the URL, and store it as the file. Write-only." />
+      </Term>
+      <Term Name="teamCreationMode" Type="Edm.String" AppliesTo="microsoft.graph.team">
+        <Annotation Term="Org.OData.Core.V1.LongDescription" String="Indicates that the team is in migration state and is currently being used for migration purposes. It accepts one value: migration." />
+      </Term>
       <Annotations Target="microsoft.graph.directoryAudit" />
       <Annotations Target="microsoft.graph.signIn" />
       <Annotations Target="microsoft.graph.directoryObject">
@@ -28233,7 +28439,7 @@
           <Annotation Term="Org.OData.Core.V1.Description" String="Indicates the type of the call. Possible values are: unknown, groupCall, peerToPeer, unknownFutureValue." />
         </Property>
         <Property Name="version" Type="Edm.Int64" Nullable="false">
-          <Annotation Term="Org.OData.Core.V1.Description" String="Monotonically increasing version of the call record. Higher version call records with the same id includes additional data compared to the lower version." />
+          <Annotation Term="Org.OData.Core.V1.Description" String="Monotonically increasing version of the call record. Higher version call records with the same ID includes additional data compared to the lower version." />
         </Property>
         <NavigationProperty Name="sessions" Type="Collection(microsoft.graph.callRecords.session)" ContainsTarget="true">
           <Annotation Term="Org.OData.Core.V1.Description" String="List of sessions involved in the call. Peer-to-peer calls typically only have one session, whereas group calls typically have at least one session per participant. Read-only. Nullable." />