Updates from: 01/12/2022 02:11:55
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Channel Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-delete-members.md
If successful, this method returns a `204 No Content` response code.
### Request
-Here is an example of the request.
+The following is an example of a request.
# [HTTP](#tab/http)
DELETE https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d
### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response"
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-get.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
In addition, apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-list.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
In addition, apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Provisioningobjectsummary List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/provisioningobjectsummary-list.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
## HTTP request
v1.0 Signin Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/signin-get.md
One of the following permissions is required to call this API. To learn more, in
| Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/signin-list.md
One of the following permissions is required to call this API. To learn more, in
| Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Table Post Rows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/table-post-rows.md
One of the following permissions is required to call this API. To learn more, in
POST /me/drive/items/{id}/workbook/tables/{id|name}/rows POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
-POST /me/drive/root:/{item-path}:/workbookworksheets/{id|name}/tables/{id|name}/rows
+POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows
``` ## Request headers
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list.md
Content-type: application/json
The following is an example of the request. Details for the **signInActivity** property require an Azure AD Premium P1/P2 license and the AuditLog.Read.All permission.
->**Note:** There's a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) with retrieving the **signInActivity** property.
+>**Note:** There's a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) with retrieving the **signInActivity** property.
# [HTTP](#tab/http) <!-- {
Content-type: application/json
The following is an example of the request. Details for the **signInActivity** property require an Azure AD Premium P1/P2 license and the AuditLog.Read.All permission.
->**Note:** There's a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) with retrieving the **signInActivity** property.
+>**Note:** There's a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) with retrieving the **signInActivity** property.
<!-- { "blockType": "ignored",
v1.0 Windowsupdates Azureaddevice Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-azureaddevice-delete.md
Title: "Delete azureADDevice" description: "Delete an azureADDevice object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Azureaddevice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-azureaddevice-get.md
Title: "Get azureADDevice" description: "Read the properties of an azureADDevice object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Catalog List Entries https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-catalog-list-entries.md
Title: "List entries" description: "Get a list of catalogEntry resources from the catalog."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deployment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deployment-delete.md
Title: "Delete deployment" description: "Delete a deployment object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deployment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deployment-get.md
Title: "Get deployment" description: "Read the properties and relationships of a deployment object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deployment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deployment-update.md
Title: "Update deployment" description: "Update the properties of a deployment object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deploymentaudience List Exclusions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deploymentaudience-list-exclusions.md
Title: "List deployment audience exclusions" description: "List the updatableAsset resources that are excluded from a deploymentAudience."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deploymentaudience List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deploymentaudience-list-members.md
Title: "List deployment audience members" description: "List the updatableAsset resources that are members of a deploymentAudience."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deploymentaudience Updateaudience https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deploymentaudience-updateaudience.md
Title: "deploymentAudience: updateAudience" description: "Update the members and exclusions collections of a deploymentAudience."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Deploymentaudience Updateaudiencebyid https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deploymentaudience-updateaudiencebyid.md
Title: "deploymentAudience: updateAudienceById" description: "Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableasset Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableasset-delete.md
Title: "Delete updatableAsset" description: "Delete an updatableAsset object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableasset Enrollassets https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableasset-enrollassets.md
Title: "updatableAsset: enrollAssets" description: "Enroll updatableAsset resources in update management by the deployment service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableasset Enrollassetsbyid https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableasset-enrollassetsbyid.md
Title: "updatableAsset: enrollAssetsById" description: "Enroll updatableAsset resources of the same type in update management by the deployment service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableasset Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableasset-get.md
Title: "Get updatableAsset" description: "Read the properties and relationships of an updatableAsset object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableasset Unenrollassets https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableasset-unenrollassets.md
Title: "updatableAsset: unenrollAssets" description: "Unenroll updatableAsset resources from update management by the deployment service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableasset Unenrollassetsbyid https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableasset-unenrollassetsbyid.md
Title: "updatableAsset: unenrollAssetsById" description: "Unenroll updatableAsset resources of the same type from update management by the deployment service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup Addmembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-addmembers.md
Title: "updatableAssetGroup: addMembers" description: "Add members to an updatableAssetGroup."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup Addmembersbyid https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-addmembersbyid.md
Title: "updatableAssetGroup: addMembersById" description: "Add members of the same type to an updatableAssetGroup."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-delete.md
Title: "Delete updatableAssetGroup" description: "Delete an updatableAssetGroup object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-get.md
Title: "Get updatableAssetGroup" description: "Read the properties and relationships of an updatableAssetGroup object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-list-members.md
Title: "List updatable asset group members" description: "List the members of an updatableAssetGroup resource. Members are of the azureADDevice type."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup Removemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-removemembers.md
Title: "updatableAssetGroup: removeMembers" description: "Remove members from an updatableAssetGroup."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updatableassetgroup Removemembersbyid https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updatableassetgroup-removemembersbyid.md
Title: "updatableAssetGroup: removeMembersById" description: "Remove members of the same type from an updatableAssetGroup."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updates List Deployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-list-deployments.md
Title: "List deployments" description: "Get a list of deployment objects and their properties."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updates List Updatableassets Azureaddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-list-updatableassets-azureaddevice.md
Title: "List azureADDevice resources" description: "Get a list of azureADDevice objects and their properties."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updates List Updatableassets Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-list-updatableassets-updatableassetgroup.md
Title: "List updatableAssetGroup resources" description: "Get a list of updatableAssetGroup objects and their properties."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updates List Updatableassets https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-list-updatableassets.md
Title: "List updatableAssets" description: "Get a list of updatableAsset objects and their properties."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updates Post Deployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-post-deployments.md
Title: "Create deployment" description: "Create a new deployment object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Windowsupdates Updates Post Updatableassets Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-post-updatableassets-updatableassetgroup.md
Title: "Create updatableAssetGroup" description: "Create a new updatableAssetGroup object."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: apiPageType
v1.0 Workbook Tablerowoperationresult https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/workbook-tablerowoperationresult.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /driveItem/workbook/tableRowOperationResult(key={operation-id})
+GET /me/drive/items/{id}/workbook/tableRowOperationResult(key={operation-id})
+GET /me/drive/root:/{item-path}:/workbook/tableRowOperationResult(key={operation-id})
``` ## Function parameters
The following example shows a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/driveItem/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
+GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
```
v1.0 Enums Windowsupdates https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums-windowsupdates.md
Title: "Microsoft Graph Windows Updates enumeration values" description: "Microsoft Graph Windows Updates enumeration values"-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: enumTypes
v1.0 Social Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/social-overview.md
Use the insights API to identify the most relevant documents for a user:
- List documents [trending around](../api/insights-list-trending.md) a user - List documents [used by](../api/insights-list-used.md) a user - List documents [shared with or shared by](../api/insights-list-shared.md) a user-- Explore ways to [customize privacy settings for item insights](/graph/insights-customize-item-insights-privacy.md) in an organization.
+- Explore ways to [customize privacy settings for item insights](/graph/insights-customize-item-insights-privacy) in an organization.
## Manage @-Mentions
v1.0 Subjectrightsrequest Subjectrightsrequestapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/subjectrightsrequest-subjectrightsrequestapioverview.md
The API includes the following key entities.
| Subject rights request detail | [microsoft.graph.subjectRightsRequestDetail](subjectRightsRequestDetail.md) | Represents the details of a subject rights request, including number of items found, number of items reviewed, and so on. | | Subject rights request stage detail | [microsoft.graph.subjectRightsRequestStageDetail](subjectRightsRequestStageDetail.md) | Represents the properties of the stages of a subject rights request. |
->[!IMPORTANT]
->The subject rights request API permissions are not currently available. For details, see [Known issues](/graph/known-issues#compliance).
+
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
| legalAgeGroupClassification | [legalAgeGroupClassification](#legalagegroupclassification-values) | 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](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. | | licenseAssignmentStates | [licenseAssignmentState](licenseassignmentstate.md) collection | State of license assignments for this user. Read-only. <br><br>Returned only on `$select`. | | mail | String | The SMTP address for the user, for example, `admin@contoso.com`. Changes to this property will also update the user's **proxyAddresses** collection to include the value as an SMTP address. For Azure AD B2C accounts, this property can be updated up to only ten times with unique SMTP addresses. This property cannot contain accent characters. <br><br> Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`, and `eq` on `null` values). |
-| mailboxSettings | [mailboxSettings](mailboxsettings.md) | Settings for the primary mailbox of the signed-in user. You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update-mailboxsettings.md) settings for sending automatic replies to incoming messages, locale, and time zone. <br><br>Returned only on `$select`. |
+| mailboxSettings | [mailboxSettings](mailboxsettings.md) | Settings for the primary mailbox of the signed-in user. You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update-mailboxsettings.md) settings for sending automatic replies to incoming messages, locale, and time zone. For more information, see [User preferences for languages and regional formats](#user-preferences-for-languages-and-regional-formats). <br><br>Returned only on `$select`. |
| mailNickname | String | The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values). | | mobilePhone | String | The primary cellular telephone number for the user. Read-only for users synced from on-premises directory. <br><br> Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| | mySite | String | The URL for the user's personal site. <br><br>Returned only on `$select`. |
This resource supports:
| preferredLanguage | String | The preferred language for the user. Should follow ISO 639-1 Code; for example `en-US`. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values). | | preferredName | String | The preferred name for the user. <br><br>Returned only on `$select`. | | provisionedPlans | [provisionedPlan](provisionedplan.md) collection | The plans that are provisioned for the user. Read-only. Not nullable. Supports `$filter` (`eq`, `not`, `ge`, `le`).|
-| proxyAddresses | String collection | For example: `["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]`. For Azure AD B2C accounts, this property has a limit of ten unique addresses. Read-only, Not nullable. <br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`). |
+| proxyAddresses | String collection | For example: `["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]`. The proxy address prefixed with `SMTP` (capitalized) is the primary proxy address while those prefixed with `smtp` are the secondary proxy addresses. For Azure AD B2C accounts, this property has a limit of ten unique addresses. Read-only in Microsoft Graph; you can update this property only through the [Microsoft 365 admin center](/exchange/recipients-in-exchange-online/manage-user-mailboxes/add-or-remove-email-addresses). Not nullable. <br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`). |
| refreshTokensValidFromDateTime | DateTimeOffset | 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 [invalidateAllRefreshTokens](../api/user-invalidateallrefreshtokens.md) to reset.| | responsibilities | String collection | A list for the user to enumerate their responsibilities. <br><br>Returned only on `$select`. | | schools | String collection | A list for the user to enumerate the schools they have attended. <br><br>Returned only on `$select`. |
This resource supports:
| userPrincipalName | 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](organization.md).<br>NOTE: This property cannot contain accent characters. Only the following characters are allowed `A - Z`, `a - z`, `0 - 9`, ` ' . - _ ! # ^ ~`. For the complete list of allowed characters, see [username policies](/azure/active-directory/authentication/concept-sspr-policy#userprincipalname-policies-that-apply-to-all-user-accounts). <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`) and `$orderBy`. | userType | String | A String value that can be used to classify user types in your directory, such as `Member` and `Guest`. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `in`, and `eq` on `null` values). **NOTE:** For more information about the permissions for member and guest users, see [What are the default user permissions in Azure Active Directory?](/azure/active-directory/fundamentals/users-default-permissions#member-and-guest-users) |
+### User preferences for languages and regional formats
+The **user** resource contains a [mailboxSettings](../resources/mailboxsettings.md) property which includes the user's preferred language, date and time formatting, default time zone, and other settings specifically for their primary Exchange mailbox. These preferences are targeted for mail clients and are only available if the user has a mailbox provisioned. You can choose to use **mailboxSettings** if your scenario focuses only on Outlook mail, calendar, contacts, or to-do tasks.
+
+In addition to **mailboxSettings**, **user** includes a relationship via [userSettings](../resources/usersettings.md) to [regionalAndLanguageSettings](../resources/regionalandlanguagesettings.md), the superset of language and regional formatting preferences that can be used by any application to provide the user with the best language and regional formatting experience. Use **userSettings** for a consistent experience across apps that tap into the Azure AD user profile to reflect the same user preferences.
+ ### Legal age group property definitions This section explains how the three age group properties (**legalAgeGroupClassification**, **ageGroup** and **consentProvidedForMinor**) are used by Azure AD administrators and enterprise application developers to meet age-related regulations:
This section explains how the three age group properties (**legalAgeGroupClassif
- **ageGroup** and **consentProvidedForMinor** are optional properties used by Azure AD administrators to help ensure the use of an account is handled correctly based on the age-related regulatory rules governing the user's country or region. For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". Applications used by his students are then able to suppress features that are not suitable for minors.
-<!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience.
-For some reason they are not defined as enums in the CSDL.
-Hence the type of the corresponding 3 properties remain as String type in the Properties table.
>+
+<!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience but they are String types.-->
#### legalAgeGroupClassification values
Hence the type of the corresponding 3 properties remain as String type in the Pr
|transitiveReports|[directoryObject](directoryobject.md) collection | The transitive reports for a user. Read-only.| |usageRight|[usageRight](usageright.md) collection|Represents the usage rights a user has been granted. |
-### User preferences for languages and regional formats
-The **user** resource contains a [mailboxSettings](../resources/mailboxsettings.md) property which includes the user's preferred language, date and time formatting, default time zone, and other settings specifically for their primary Exchange mailbox. These preferences are targeted for mail clients and are only available if the user has a mailbox provisioned. You can choose to use **mailboxSettings** if your scenario focuses only on Outlook mail, calendar, contacts, or to-do tasks.
-
-In addition to **mailboxSettings**, **user** includes a relationship via [userSettings](../resources/usersettings.md) to [regionalAndLanguageSettings](../resources/regionalandlanguagesettings.md), the superset of language and regional formatting preferences that can be used by any application to provide the user with the best language and regional formatting experience. Use **userSettings** for a consistent experience across apps that tap into the Azure AD user profile to reflect the same user preferences.
- ## JSON representation Here is a JSON representation of the resource
v1.0 Windowsupdates Azureaddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-azureaddevice.md
Title: "azureADDevice resource type" description: "Represents a device in Azure Active Directory (Azure AD) that is registered with the deployment service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Azureaddeviceregistrationerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-azureaddeviceregistrationerror.md
Title: "azureADDeviceRegistrationError resource type" description: "An error in the registration process of an Azure AD device that prevents the service from enrolling the device in update management or deploying content to the device."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Catalog https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-catalog.md
Title: "catalog resource type" description: "Entity representing the catalog of content that you can approve for deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Catalogentry https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-catalogentry.md
Title: "catalogEntry resource type" description: "Metadata for a piece of content that you can approve for deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Deployablecontent https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-deployablecontent.md
Title: "deployableContent resource type" description: "Represents content that is deployable by the service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Deployment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-deployment.md
Title: "deployment resource type" description: "Represents the deployment of content to a set of devices."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Deploymentaudience https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-deploymentaudience.md
Title: "deploymentAudience resource type" description: "The set of updatableAsset resources to which a deployment can apply."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Deploymentsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-deploymentsettings.md
Title: "deploymentSettings resource type" description: "Determines when and how the service deploys an update."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Deploymentstate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-deploymentstate.md
Title: "deploymentState resource type" description: "Describes and controls the current state of a deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Deploymentstatereason https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-deploymentstatereason.md
Title: "deploymentStateReason resource type" description: "A reason for a particular deployment state."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Expeditedqualityupdatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-expeditedqualityupdatereference.md
Title: "expeditedQualityUpdateReference resource type" description: "Represents Windows 10 quality update content to expedite."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Featureupdatecatalogentry https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-featureupdatecatalogentry.md
Title: "featureUpdateCatalogEntry resource type" description: "Metadata for a Windows 10 feature update that you can approve for deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Featureupdatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-featureupdatereference.md
Title: "featureUpdateReference resource type" description: "Represents Windows 10 feature update content."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Monitoringrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-monitoringrule.md
Title: "monitoringRule resource type" description: "Rule defining a signal and threshold to monitor, and the action to perform when met."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Monitoringsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-monitoringsettings.md
Title: "monitoringSettings resource type" description: "Settings controlling automated monitoring and response in a deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Qualityupdatecatalogentry https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-qualityupdatecatalogentry.md
Title: "qualityUpdateCatalogEntry resource type" description: "Metadata for a Windows 10 quality update that you can be approve for deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Qualityupdatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-qualityupdatereference.md
Title: "qualityUpdateReference resource type" description: "Represents Windows 10 quality update content."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Rolloutsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-rolloutsettings.md
Title: "rolloutSettings resource type" description: "Settings controlling how the service deploys an update over time."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Safeguardprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-safeguardprofile.md
Title: "safeguardProfile resource type" description: "Describes the issue(s) against which the service safeguards devices."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Safeguardsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-safeguardsettings.md
Title: "safeguardSettings resource type" description: "Manages the safeguards that the service applies to devices in a deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Softwareupdatecatalogentry https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-softwareupdatecatalogentry.md
Title: "softwareUpdateCatalogEntry resource type" description: "Metadata for a software update that you can approve for deployment."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Softwareupdatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-softwareupdatereference.md
Title: "softwareUpdateReference resource type" description: "Represents specific update content."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Updatableasset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-updatableasset.md
Title: "updatableAsset resource type" description: "Represents an asset that can receive updates."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Updatableassetenrollment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-updatableassetenrollment.md
Title: "updatableAssetEnrollment resource type" description: "Represents an enrollment into an area of the service."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Updatableasseterror https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-updatableasseterror.md
Title: "updatableAssetError resource type" description: "An abstract type that represents an error which prevents the deployment service from enrolling an azureADDevice in update management, or deploying content to the device"-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-updatableassetgroup.md
Title: "updatableAssetGroup resource type" description: "A group of azureADDevice resources that can receive updates."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Updatemanagementenrollment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-updatemanagementenrollment.md
Title: "updateManagementEnrollment resource type" description: "Represents enrollment into management by the service of a certain update category."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Updates https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-updates.md
Title: "updates resource type" description: "Entity that acts as a container for all Windows Update for Business deployment service functionality."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Userexperiencesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-userexperiencesettings.md
Title: "userExperienceSettings resource type" description: "Settings controlling the user's update experience on a device."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Windows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-windows.md
Title: "windows resource type" description: "Entity that acts as a container for Windows functionality."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Windowsdeploymentsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-windowsdeploymentsettings.md
Title: "windowsDeploymentSettings resource type" description: "Settings controlling when and how the service deploys a Windows 10 update."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Windowsupdates Windowsupdatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowsupdates-windowsupdatereference.md
Title: "windowsUpdateReference resource type" description: "Represents specific Windows 10 update content."-+ ms.localizationpriority: medium ms.prod: "w10" doc_type: resourcePageType
v1.0 Channel Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-delete-members.md
If successful, this method returns a `204 No Content` response code.
### Request
-Here is an example of the request.
+The following is an example of a request.
# [HTTP](#tab/http)
DELETE https://graph.microsoft.com/v1.0/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d
### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response"
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryaudit-get.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
## HTTP request
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryaudit-list.md
One of the following permissions is required to call this API. To learn more, in
| Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
## HTTP request
v1.0 Provisioningobjectsummary List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/provisioningobjectsummary-list.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
## HTTP request
v1.0 Signin Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/signin-get.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/signin-list.md
One of the following permissions is required to call this API. To learn more, in
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
-> This API has a [known issue](/graph//graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
+> This API has a [known issue](/graph/known-issues#license-check-errors-for-azure-ad-activity-reports) and currently requires consent to both the **AuditLog.Read.All** and **Directory.Read.All** permissions.
Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Table Post Rows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/table-post-rows.md
One of the following permissions is required to call this API. To learn more, in
POST /me/drive/items/{id}/workbook/tables/{id|name}/rows POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
-POST /me/drive/root:/{item-path}:/workbookworksheets/{id|name}/tables/{id|name}/rows
+POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows
``` ## Request headers
v1.0 Workbook Tablerowoperationresult https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/workbook-tablerowoperationresult.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /driveItem/workbook/tableRowOperationResult(key={operation-id})
+GET /me/drive/items/{id}/workbook/tableRowOperationResult(key={operation-id})
+GET /me/drive/root:/{item-path}:/workbook/tableRowOperationResult(key={operation-id})
``` ## Function parameters
The following example shows a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/driveItem/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
+GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
```
v1.0 Subjectrightsrequest Subjectrightsrequestapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/subjectrightsrequest-subjectrightsrequestapioverview.md
The API includes the following key entities.
| Subject rights request detail | [microsoft.graph.subjectRightsRequestDetail](subjectRightsRequestDetail.md) | Represents the details of a subject rights request, including number of items found, number of items reviewed, and so on. | | Subject rights request stage detail | [microsoft.graph.subjectRightsRequestStageDetail](subjectRightsRequestStageDetail.md) | Represents the properties of the stages of a subject rights request. |
->[!IMPORTANT]
->The subject rights request API permissions are not currently available. For details, see [Known issues](/graph/known-issues#compliance).
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teams-api-overview.md
Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-i
|[teamsTab](../resources/teamstab.md) |[List](../api/channel-list-tabs.md), [create](../api/channel-post-tabs.md), [read](../api/channel-get-tabs.md), [update](../api/channel-patch-tabs.md), [delete](../api/channel-delete-tabs.md) | |[teamsApp](../resources/teamsapp.md)|[List](../api/appcatalogs-list-teamsapps.md), [publish](../api/teamsapp-publish.md), [update](../api/teamsapp-update.md), [remove](../api/teamsapp-delete.md)| |[teamsAppInstallation](../resources/teamsappinstallation.md)| [List](../api/team-list-installedapps.md), [install](../api/team-post-installedapps.md), [upgrade](../api/team-delete-installedapps.md), [remove](../api/team-delete-installedapps.md) |
-|[chatMessage](../resources/chatmessage.md)| [list in channel](../api/channel-list-messages.md), [list in chat](../api/chat-list-messages.md), [send](../api/chatmessage-post.md), [read in channel](../api/chatmessage-get.md), [read in chat](../api/chatmessage-get.md)|
+|[chatMessage](../resources/chatmessage.md)| [List in channel](../api/channel-list-messages.md), [list in chat](../api/chat-list-messages.md), [send](../api/chatmessage-post.md), [read in channel](../api/chatmessage-get.md), [read in chat](../api/chatmessage-get.md)|
|[call](../resources/call.md)| [Answer](../api/call-answer.md), [reject](../api/call-reject.md), [redirect](../api/call-redirect.md), [mute](../api/call-mute.md), [unmute](../api/call-unmute.md), [change screen sharing role](../api/call-changescreensharingrole.md), [list participants](../api/call-list-participants.md), [invite participants](../api/participant-invite.md) | |[schedule](../resources/schedule.md)| [Create or replace](../api/team-put-schedule.md), [get](../api/schedule-get.md), [share](../api/schedule-share.md) |
-|[schedulingGroup](../resources/schedulinggroup.md)| [Create](../api/schedule-post-schedulinggroups.md), [List](../api/schedule-list-schedulinggroups.md), [Get](../api/schedulinggroup-get.md), [Replace](../api/schedulinggroup-put.md), [Delete](../api/schedulinggroup-delete.md) |
-|activityFeedNotification| [Send notification to user in scope of a chat](../api/chat-sendactivitynotification.md), [Send notification to user in scope of a team](../api/team-sendactivitynotification.md), [Send notification to user in personal scope](../api/userteamwork-sendactivitynotification.md)|
-|[shift](../resources/shift.md)| [Create](../api/schedule-post-shifts.md), [List](../api/schedule-list-shifts.md), [Get](../api/shift-get.md), [Replace](../api/shift-put.md), [Delete](../api/shift-delete.md) |
-|[timeOff](../resources/timeoff.md)| [Create](../api/schedule-post-timesoff.md), [List](../api/schedule-list-timesoff.md), [Get](../api/timeoff-get.md), [Replace](../api/timeoff-put.md), [Delete](../api/timeoff-delete.md) |
-|[timeOffReason](../resources/timeoffreason.md)| [Create](../api/schedule-post-timeoffreasons.md), [List](../api/schedule-list-timeoffreasons.md), [Get](../api/timeoffreason-get.md), [Replace](../api/timeoffreason-put.md), [Delete](../api/timeoffreason-delete.md) |
+|[schedulingGroup](../resources/schedulinggroup.md)| [Create](../api/schedule-post-schedulinggroups.md), [list](../api/schedule-list-schedulinggroups.md), [get](../api/schedulinggroup-get.md), [replace](../api/schedulinggroup-put.md), [delete](../api/schedulinggroup-delete.md) |
+|activityFeedNotification| [Send notification to user in scope of a chat](../api/chat-sendactivitynotification.md), [send notification to user in scope of a team](../api/team-sendactivitynotification.md), [send notification to user in personal scope](../api/userteamwork-sendactivitynotification.md)|
+|[shift](../resources/shift.md)| [Create](../api/schedule-post-shifts.md), [list](../api/schedule-list-shifts.md), [get](../api/shift-get.md), [replace](../api/shift-put.md), [delete](../api/shift-delete.md) |
+|[timeOff](../resources/timeoff.md)| [Create](../api/schedule-post-timesoff.md), [list](../api/schedule-list-timesoff.md), [get](../api/timeoff-get.md), [replace](../api/timeoff-put.md), [delete](../api/timeoff-delete.md) |
+|[timeOffReason](../resources/timeoffreason.md)| [Create](../api/schedule-post-timeoffreasons.md), [list](../api/schedule-list-timeoffreasons.md), [get](../api/timeoffreason-get.md), [replace](../api/timeoffreason-put.md), [delete](../api/timeoffreason-delete.md) |
## Microsoft Teams limits
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/user.md
This resource supports:
|legalAgeGroupClassification|[legalAgeGroupClassification](#legalagegroupclassification-values)| 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](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`.| |licenseAssignmentStates|[licenseAssignmentState](licenseassignmentstate.md) collection|State of license assignments for this user. Read-only. <br><br>Returned only on `$select`.| |mail|String|The SMTP address for the user, for example, `jeff@contoso.onmicrosoft.com`.<br>Changes to this property will also update the user's **proxyAddresses** collection to include the value as an SMTP address. For Azure AD B2C accounts, this property can be updated up to only ten times with unique SMTP addresses. This property cannot contain accent characters.<br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`, and `eq` on `null` values).|
-|mailboxSettings|[mailboxSettings](mailboxsettings.md)|Settings for the primary mailbox of the signed-in user. You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update-mailboxsettings.md) settings for sending automatic replies to incoming messages, locale and time zone.<br><br>Returned only on `$select`.|
+|mailboxSettings|[mailboxSettings](mailboxsettings.md)|Settings for the primary mailbox of the signed-in user. You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update-mailboxsettings.md) settings for sending automatic replies to incoming messages, locale and time zone. <br><br>Returned only on `$select`.|
|mailNickname|String|The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| |mobilePhone|String|The primary cellular telephone number for the user. Read-only for users synced from on-premises directory. Maximum length is 64 characters. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values). | |mySite|String|The URL for the user's personal site. <br><br>Returned only on `$select`.|
This resource supports:
|preferredLanguage|String|The preferred language for the user. Should follow ISO 639-1 Code; for example `en-US`. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values)| |preferredName|String|The preferred name for the user. <br><br>Returned only on `$select`.| |provisionedPlans|[provisionedPlan](provisionedplan.md) collection|The plans that are provisioned for the user. Read-only. Not nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `not`, `ge`, `le`).|
-|proxyAddresses|String collection|For example: `["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]`. For Azure AD B2C accounts, this property has a limit of ten unique addresses. Read-only, Not nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`).|
+|proxyAddresses|String collection|For example: `["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]`. The proxy address prefixed with `SMTP` (capitalized) is the primary proxy address while those prefixed with `smtp` are the secondary proxy addresses. For Azure AD B2C accounts, this property has a limit of ten unique addresses. Read-only in Microsoft Graph; you can update this property only through the [Microsoft 365 admin center](/exchange/recipients-in-exchange-online/manage-user-mailboxes/add-or-remove-email-addresses). Not nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`).|
|refreshTokensValidFromDateTime|DateTimeOffset|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. <br><br>Returned only on `$select`. Read-only. | |responsibilities|String collection|A list for the user to enumerate their responsibilities. <br><br>Returned only on `$select`.| |schools|String collection|A list for the user to enumerate the schools they have attended. <br><br>Returned only on `$select`.|
This section explains how the three age group properties (**legalAgeGroupClassif
For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. Cameron then creates all the accounts and sets **ageGroup** to `minor` and **consentProvidedForMinor** to `granted`. Applications used by his students are then able to suppress features that are not suitable for minors.
-<!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience.
-For some reason they are not defined as enums in the CSDL.
-Hence the type of the corresponding 3 properties remain as string type in the Properties table.
>
+<!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience but they are String types.-->
#### legalAgeGroupClassification values
Hence the type of the corresponding 3 properties remain as string type in the Pr
## JSON representation
-Here is a JSON representation of the resource
+The following is a JSON representation of the resource.
<!--{ "blockType": "resource",