| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Chat Delete Pinnedmessages | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-delete-pinnedmessages.md | + + Title: "Unpin a message from a chat" +description: "Unpin a message from a chat." ++ms.localizationpriority: medium +++# Unpin a message from a chat +Namespace: microsoft.graph +++Unpin a message from a [chat](../resources/chat.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account) | Chat.ReadWrite | +|Delegated (personal Microsoft account) | Not supported. | +|Application | Chat.ReadWrite.All | ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfoId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. +<!-- { + "blockType": "request", + "name": "delete_pinnedchatmessageinfo" +} +--> +``` http +DELETE https://graph.microsoft.com/beta/chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/pinnedMessages/1616964509832 +``` ++### Response +The following is an example of the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
| v1.0 | Chat List Pinnedmessages | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-pinnedmessages.md | + + Title: "List pinned messages in a chat" +description: "Get a list of pinned messages in a chat." ++ms.localizationpriority: medium +++# List pinned messages in a chat +Namespace: microsoft.graph +++Get a list of [pinnedChatMessages](../resources/pinnedChatMessageInfo.md) in a [chat](../resources/chat.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account) | Chat.Read, Chat.ReadWrite | +|Delegated (personal Microsoft account) | Not supported. | +|Application | ChatMessage.Read.All, Chat.Read.All, Chat.ReadWrite.All | ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /chats/{chat-id}/pinnedMessages +``` ++## Optional query parameters +This method supports the `$expand` [OData query parameter](/graph/query-parameters) to help customize the response. ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md) objects in the response body. ++## Examples ++### Example 1: List all the pinned messages in a chat +The following example shows a request that lists all the pinned messages in a chat. ++### Request +The following is an example of a request. +<!-- { + "blockType": "request", + "name": "list_pinnedchatmessageinfo" +} +--> +``` http +GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@thread.v2/pinnedMessages +``` ++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.pinnedChatMessageInfo", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.pinnedChatMessageInfo", + "id": "1616964509832" + }, + { + "@odata.type": "#microsoft.graph.pinnedChatMessageInfo", + "id": "1615971548136" + } + ] +} +``` ++### Example 2: List all the pinned messages in a chat along with the associated chat message +The following example shows a request that lists all the pinned messages in a chat along with the associated chat message. ++### Request +The following is an example of a request. +<!-- { + "blockType": "request", + "name": "list_pinnedchatmessageinfo" +} +--> +``` http +GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@thread.v2/pinnedMessages?$expand=message +``` ++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.pinnedChatMessageInfo", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "1616964509832", + "message": { + "id": "1616964509832", + "replyToId": null, + "etag": "1616964509832", + "messageType": "message", + "createdDateTime": "2021-03-28T20:48:29.832Z", + "lastModifiedDateTime": "2021-03-28T20:48:29.832Z", + "lastEditedDateTime": null, + "deletedDateTime": null, + "subject": null, + "summary": null, + "chatId": "19:2da4c29f6d7041eca70b638b43d45437@thread.v2", + "importance": "normal", + "locale": "en-us", + "webUrl": null, + "channelIdentity": null, + "onBehalfOf": null, + "policyViolation": null, + "eventDetail": null, + "from": { + "application": null, + "device": null, + "user": { + "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2", + "displayName": "Robin Kline", + "userIdentityType": "aadUser" + } + }, + "body": { + "contentType": "text", + "content": "Hello world" + }, + "attachments": [], + "mentions": [], + "reactions": [] + } + }, + { + "id": "1615971548136", + "message": { + "id": "1615971548136", + "replyToId": null, + "etag": "1615971548136", + "messageType": "message", + "createdDateTime": "2021-03-17T08:59:08.136Z", + "lastModifiedDateTime": "2021-03-17T08:59:08.136Z", + "lastEditedDateTime": null, + "deletedDateTime": null, + "subject": null, + "summary": null, + "chatId": "19:2da4c29f6d7041eca70b638b43d45437@thread.v2", + "importance": "normal", + "locale": "en-us", + "webUrl": null, + "channelIdentity": null, + "onBehalfOf": null, + "policyViolation": null, + "eventDetail": null, + "from": { + "application": null, + "device": null, + "user": { + "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2", + "displayName": "Robin Kline", + "userIdentityType": "aadUser" + } + }, + "body": { + "contentType": "html", + "content": "<div><div><div><span><img height=\"63\" src=\"https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages/1615971548136/hostedContents/aWQ9eF8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNix0eXBlPTEsdXJsPWh0dHBzOi8vdXMtYXBpLmFzbS5za3lwZS5jb20vdjEvb2JqZWN0cy8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNi92aWV3cy9pbWdv/$value\" width=\"67\" style=\"vertical-align:bottom; width:67px; height:63px\"></span></div></div></div>" + }, + "attachments": [], + "mentions": [], + "reactions": [] + } + } + ] +} +``` |
| v1.0 | Chat Post Pinnedmessages | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-pinnedmessages.md | + + Title: "Pin a message in a chat" +description: "Pin a chat message in the specified chat." ++ms.localizationpriority: medium +++# Pin a message in a chat +Namespace: microsoft.graph +++Pin a chat message in the specified [chat](../resources/chat.md). This API cannot create a new chat; you must use the [list chats](chat-list.md) method to retrieve the ID of an existing chat before you can pin a chat message. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +| Delegated (work or school account) | ChatMessage.Send, Chat.ReadWrite | +| Delegated (personal Microsoft account) | Not supported. | +| Application | Chat.ReadWrite.All | ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /chats/{chat-Id}/pinnedMessages +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +The request body should contain the chat message ID. ++## Response ++If successful, this method returns a `201 Created` response code and a [pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. +<!-- { + "blockType": "request", + "name": "create_pinnedchatmessageinfo_from_" +} +--> +``` http +POST https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/pinnedMessages +Content-Type: application/json +Content-length: 63 ++{ + "message@odata.bind":"https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages/1616964509832" +} +``` +++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.pinnedChatMessageInfo" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.pinnedChatMessageInfo", + "id": "1616964509832" +} +``` |
| v1.0 | Crosstenantaccesspolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicy-get.md | If successful, this method returns a `200 OK` response code and a [crossTenantAc ### Request --# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_crosstenantaccesspolicy" If successful, this method returns a `200 OK` response code and a [crossTenantAc ``` http GET https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy ```-# [C#](#tab/csharp) --# [JavaScript](#tab/javascript) --# [Objective-C](#tab/objc) --# [Java](#tab/java) --# [Go](#tab/go) --# [PowerShell](#tab/powershell) --- ### Response Content-Type: application/json "@odata.type": "#microsoft.graph.crossTenantAccessPolicy", "displayName": "CrossTenantAccessPolicy", "lastModifiedDateTime": "08-23-2021Z00:00:00",- "definition": "Cross tenant access policy..." + "definition": "Cross tenant access policy...", + "allowedCloudEndpoints": ["partner.microsoftonline.cn"] } } ``` |
| v1.0 | Crosstenantaccesspolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicy-update.md | The [crossTenantAccessPolicy](../resources/crosstenantaccesspolicy.md) object si ### Request --# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_crosstenantaccesspolicy" PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy Content-Type: application/json {- "displayName": "CrossTenantAccessPolicy", + "allowedCloudEndpoints": ["microsoftonline.us", "partner.microsoftonline.cn"] } ```-# [C#](#tab/csharp) --# [JavaScript](#tab/javascript) --# [Objective-C](#tab/objc) --# [Java](#tab/java) --# [Go](#tab/go) --# [PowerShell](#tab/powershell) --- ### Response |
| v1.0 | Reportroot Getemailactivitycounts | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/reportroot-getemailactivitycounts.md | Follow the 302 redirection and the CSV file that downloads will have the followi HTTP/1.1 200 OK Content-Type: application/octet-stream -Report Refresh Date,Send,Receive,Read,Report Date,Report Period +Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period ``` ### JSON Content-Length: 242 "send": 504, "receive": 76506, "read": 12161, + "meetingCreated": 421, + "meetingInteracted": 7930, "reportDate": "2017-09-01", "reportPeriod": "7" } |
| v1.0 | Reportroot Getemailactivityusercounts | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/reportroot-getemailactivityusercounts.md | Follow the 302 redirection and the CSV file that downloads will have the followi HTTP/1.1 200 OK Content-Type: application/octet-stream -Report Refresh Date,Send,Receive,Read,Report Date,Report Period +Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period ``` ### JSON Content-Length: 237 "send": 69, "receive": 197, "read": 158, + "meetingCreated": 59, + "meetingInteracted": 90, "reportDate": "2017-09-01", "reportPeriod": "7" } |
| v1.0 | Reportroot Getemailactivityuserdetail | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/reportroot-getemailactivityuserdetail.md | The CSV file has the following headers for columns. - Send Count - Receive Count - Read Count-- Meeting Created-- Meeting Interacted+- Meeting Created Count +- Meeting Interacted Count - Assigned Products - Report Period Follow the 302 redirection and the CSV file that downloads will have the followi HTTP/1.1 200 OK Content-Type: application/octet-stream -Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Last Activity Date,Send Count,Receive Count,Read Count,Assigned Products,Report Period +Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Last Activity Date,Send Count,Receive Count,Read Count,Meeting Created Count,Meeting Interacted Count,Assigned Products,Report Period ``` ### JSON Content-Length: 424 "assignedProducts": [ "Microsoft 365 ENTERPRISE E5" ], + "meetingCreatedCount": 50, + "meetingInteractedCount": 86, "reportPeriod": "7" } ] |
| v1.0 | Tenantadmin Settings Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tenantadmin-settings-get.md | + + Title: "Get settings" +description: "Get the tenant-level settings for SharePoint and OneDrive." ++ms.localizationpriority: medium +++# Get settings +Namespace: microsoft.graph.tenantAdmin +++Get the tenant-level [settings](../resources/tenantadmin-settings.md) for SharePoint and OneDrive. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|SharePointTenantSettings.Read.All, SharePointTenantSettings.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|SharePointTenantSettings.Read.All, SharePointTenantSettings.ReadWrite.All| ++When calling on behalf of a user, the user needs to belong to one of the following admin roles. To learn more about admin roles, see [About admin roles in the Microsoft 365 admin center](/microsoft-365/admin/add-users/about-admin-roles): +* Global Administrator +* Global Reader +* SharePoint Administrator ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/sharepoint/settings +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [settings](../resources/tenantadmin-settings.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "get_settings" +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/sharepoint/settings +``` +++### Response ++The following is an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.tenantAdmin.settings" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.tenantAdmin.settings", + "id": "e79403fa-abdf-af49-56c5-f7119d8b1948", + "allowedDomainGuidsForSyncApp": [ + "bdd1ab9b-3fd0-4def-a761-ec8d7471732c", + "ad31vb6b-5zd0-7tyg-m231-kj8d6578432c" + ], + "availableManagedPathsForSiteCreation": [ + "/sites/", + "/teams/" + ], + "deletedUserPersonalSiteRetentionPeriodInDays": 344, + "excludedFileExtensionsForSyncApp": [ + ".md", + ".git" + ], + "imageTaggingOption": "basic", + "isCommentingOnSitePagesEnabled": true, + "isFileActivityNotificationEnabled": true, + "isLoopEnabled": true, + "isMacSyncAppEnabled": false, + "isResharingByExternalUsersEnabled": true, + "isSharePointMobileNotificationEnabled": true, + "isSharePointNewsfeedEnabled": true, + "isSiteCreationEnabled": true, + "isSiteCreationUIEnabled": true, + "isSitePagesCreationEnabled": true, + "isSitesStorageLimitAutomatic": true, + "isSyncButtonHiddenOnPersonalSite": true, + "isUnmanagedSyncAppForTenantRestricted": true, + "personalSiteDefaultStorageLimitInMB": 113664, + "sharingAllowedDomainList" : [ + "contoso.com", + "fabrikam.com" + ], + "sharingBlockedDomainList" : [ + "contoso.com", + "fabrikam.com" + ], + "sharingCapability": "externalUserAndGuestSharing", + "sharingDomainRestrictionMode": "allowList", + "siteCreationDefaultManagedPath": "/sites/", + "siteCreationDefaultStorageLimitInMB": 808034, + "tenantDefaultTimezone": "(UTC-05:00) Eastern Time (US and Canada)" + } +} +``` + |
| v1.0 | Tenantadmin Settings Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/tenantadmin-settings-update.md | + + Title: "Update settings" +description: "Update one or more tenant-level settings for SharePoint and OneDrive." ++ms.localizationpriority: medium +++# Update settings +Namespace: microsoft.graph.tenantAdmin +++Update one or more tenant-level [settings](../resources/tenantadmin-settings.md) for SharePoint and OneDrive. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|SharePointTenantSettings.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|SharePointTenantSettings.ReadWrite.All| ++When calling on behalf of a user, the user needs to belong to one of the following admin roles. To learn more about admin roles, see [About admin roles in the Microsoft 365 admin center](/microsoft-365/admin/add-users/about-admin-roles): +* Global Administrator +* SharePoint Administrator ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /admin/sharepoint/settings +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +The following table shows the properties that can be edited for a [settings](../resources/tenantadmin-settings.md) object. ++|Property|Type|Description| +|:|:|:| +| allowedDomainGuidsForSyncApp | GUID collection | Collection of trusted domain GUIDs for the OneDrive sync app. | +| deletedUserPersonalSiteRetentionPeriodInDays | Int32 | The number of days for preserving a deleted user's OneDrive. | +| excludedFileExtensionsForSyncApp | String collection | Collection of file extensions not uploaded by the OneDrive sync app. | +| imageTaggingOption | imageTaggingChoice | Specifies the image tagging option for the tenant. Possible values are: `disabled`, `basic`, `enhanced`. | +| isCommentingOnSitePagesEnabled | Boolean | Indicates whether comments are allowed on modern site pages in SharePoint. | +| isFileActivityNotificationEnabled | Boolean | Indicates whether push notifications are enabled for OneDrive events. | +| isLoopEnabled | Boolean | Indicates whether Fluid Framework is allowed on SharePoint sites. | +| isMacSyncAppEnabled | Boolean | Indicates whether files can be synced using the OneDrive sync app for Mac. | +| isResharingByExternalUsersEnabled | Boolean | Indicates whether guests are allowed to reshare files, folders, and sites they don't own. | +| isSharePointMobileNotificationEnabled | Boolean | Indicates whether mobile push notifications are enabled for SharePoint. | +| isSharePointNewsfeedEnabled | Boolean | Indicates whether the newsfeed is allowed on the modern site pages in SharePoint. | +| isSiteCreationEnabled | Boolean | Indicates whether users are allowed to create sites. | +| isSiteCreationUIEnabled | Boolean | Indicates whether the UI commands for creating sites are shown. | +| isSitePagesCreationEnabled | Boolean | Indicates whether creating new modern pages is allowed on SharePoint sites. | +| isSitesStorageLimitAutomatic | Boolean | Indicates whether site storage space is automatically managed or if specific storage limits are set per site. | +| isSyncButtonHiddenOnPersonalSite | Boolean | Indicates whether the sync button in OneDrive is hidden. | +| isUnmanagedSyncAppForTenantRestricted | Boolean | Indicates whether users are allowed to sync files only on PCs joined to specific domains. | +| personalSiteDefaultStorageLimitInMB | Int64 | The default OneDrive storage limit for all new and existing users who are assigned a qualifying license. Measured in megabytes (MB). | +| sharingAllowedDomainList | String collection | Collection of email domains that are allowed for sharing outside the organization. | +| sharingBlockedDomainList | String collection | Collection of email domains that are blocked for sharing outside the organization. | +| sharingCapability | sharingCapabilities | Sharing capability for the tenant. Possible values are: `disabled`, `externalUserSharingOnly`, `externalUserAndGuestSharing`, `existingExternalUserSharingOnly`. | +| sharingDomainRestrictionMode | sharingDomainRestrictionMode | Specifies the external sharing mode for domains. Possible values are: `none`, `allowList`, `blockList`. | +| siteCreationDefaultManagedPath | String | The value of the team site managed path. This is the path under which new team sites will be created. | +| siteCreationDefaultStorageLimitInMB | Int32 | The default storage quota for a new site upon creation. Measured in megabytes (MB). | +| tenantDefaultTimezone | String | The default timezone of a tenant for newly created sites. | +++++## Response ++If successful, this method returns a `200 OK` response code and an updated [settings](../resources/tenantadmin-settings.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "update_tenant_settings" +} +--> +``` http +PATCH https://graph.microsoft.com/beta/admin/sharepoint/settings +Content-Type: application/json +Content-length: 1323 ++{ + "deletedUserPersonalSiteRetentionPeriodInDays": 365, + "excludedFileExtensionsForSyncApp": [".mp3"], + "imageTaggingOption": "enhanced", + "isSitesStorageLimitAutomatic": false, + "isSyncButtonHiddenOnPersonalSite": false, + "isUnmanagedSyncAppForTenantRestricted": false, + "personalSiteDefaultStorageLimitInMB": 120000 +} +``` +++### Response ++The following is an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.tenantAdmin.settings" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.tenantAdmin.settings", + "id": "e79403fa-abdf-af49-56c5-f7119d8b1948", + "allowedDomainGuidsForSyncApp": [ + "bdd1ab9b-3fd0-4def-a761-ec8d7471732c", + "ad31vb6b-5zd0-7tyg-m231-kj8d6578432c" + ], + "availableManagedPathsForSiteCreation": [ + "/sites/", + "/teams/" + ], + "deletedUserPersonalSiteRetentionPeriodInDays": 365, + "excludedFileExtensionsForSyncApp": [ + ".mp3" + ], + "imageTaggingOption": "basic", + "isCommentingOnSitePagesEnabled": true, + "isFileActivityNotificationEnabled": true, + "isLoopEnabled": true, + "isMacSyncAppEnabled": false, + "isResharingByExternalUsersEnabled": true, + "isSharePointMobileNotificationEnabled": true, + "isSharePointNewsfeedEnabled": true, + "isSiteCreationEnabled": true, + "isSiteCreationUIEnabled": true, + "isSitePagesCreationEnabled": true, + "isSitesStorageLimitAutomatic": false, + "isSyncButtonHiddenOnPersonalSite": false, + "isUnmanagedSyncAppForTenantRestricted": false, + "personalSiteDefaultStorageLimitInMB": 120000, + "sharingAllowedDomainList" : [ + "contoso.com", + "fabrikam.com" + ], + "sharingBlockedDomainList" : [ + "contoso.com", + "fabrikam.com" + ], + "sharingCapability": "externalUserAndGuestSharing", + "sharingDomainRestrictionMode": "allowList", + "siteCreationDefaultManagedPath": "/sites/", + "siteCreationDefaultStorageLimitInMB": 808034, + "tenantDefaultTimezone": "(UTC-05:00) Eastern Time (US and Canada)" +} +``` |
| v1.0 | User Exportpersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-exportpersonaldata.md | doc_type: apiPageType Namespace: microsoft.graph -Submits a data policy operation request, made by a company administrator to export an organizational user's data. +Submit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's data stored in OneDrive and their activity reports. For more guidance about exporting data while complying with regulations, see [Data Subject Requests and the GDPR and CCPA](/compliance/regulatory/gdpr-data-subject-requests). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
| v1.0 | Admin | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/admin.md | None. |Relationship|Type|Description| |:|:|:| | serviceAnnouncement | [serviceAnnouncement](serviceannouncement.md) | A container for service communications resources. Read-only. |-|windows|[microsoft.graph.windowsUpdates.windows](../resources/windowsupdates-windows.md)|A container for all Windows Update for Business deployment service functionality. Read-only.| +| sharepoint |[microsoft.graph.tenantAdmin.sharepoint](../resources/tenantadmin-sharepoint.md)|A container for administrative resources to manage tenant-level settings for SharePoint and OneDrive.| +| windows |[microsoft.graph.windowsUpdates.windows](../resources/windowsupdates-windows.md)|A container for all Windows Update for Business deployment service functionality. Read-only.| ## JSON representation The following is a JSON representation of the resource. |
| v1.0 | Chat | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/chat.md | A chat is a collection of [chatMessages](chatmessage.md) between one or more par | **Operations** ||| |[List operations on chat](../api/chat-list-operations.md) | [teamsAsyncOperation](teamsAsyncOperation.md) collection | Get the list of async operations that ran or are running on the chat.| |[Get operation on chat](../api/teamsasyncoperation-get.md#example-get-operation-on-chat) | [teamsAsyncOperation](teamsAsyncOperation.md) | Get a single async operation that ran or is running on the chat.|+| **Pinned messages** ||| +|[List pinned messages](../api/chat-list-pinnedmessages.md)|[pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md) collection|Get a list of pinned messages in a chat.| +|[Pin a message](../api/chat-post-pinnedmessages.md)|[pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md)|Pin a chat message in a chat.| +|[Unpin a message](../api/chat-delete-pinnedmessages.md)|None|Unpin a message from a chat.| >**Note:** When using application permissions, be sure you know how you're going to get the chat ID. Because listing chats with application permissions is not supported, not all scenarios are possible. It is possible to get chat IDs with delegated permissions, and from [change notifications for /chats/getAllMessages](../api/subscription-post-subscriptions.md) with application permissions. not all scenarios are possible. It is possible to get chat IDs with delegated pe | Relationship | Type |Description| |:|:--|:-| | installedApps | [teamsAppInstallation](teamsappinstallation.md) collection | A collection of all the apps in the chat. Nullable. |+| lastMessagePreview | [chatMessageInfo](chatmessageinfo.md)| Preview of the last message sent in the chat. Null if no messages have been sent in the chat. Currently, only the [list chats](../api/chat-list.md) operation supports this property.| | members | [conversationMember](conversationmember.md) collection | A collection of all the members in the chat. Nullable. | | messages | [chatMessage](chatmessage.md) collection | A collection of all the messages in the chat. Nullable. | | permissionGrants| [resourceSpecificPermissionGrant](resourcespecificpermissiongrant.md) collection| A collection of permissions granted to apps for the chat.|-| operations | [teamsAsyncOperation](teamsasyncoperation.md) collection | A collection of all the Teams async operations that ran or are running on the chat. Nullable. -| lastMessagePreview | [chatMessageInfo](chatmessageinfo.md)| Preview of the last message sent in the chat. Null if no messages have been sent in the chat. Currently, only the [list chats](../api/chat-list.md) operation supports this property.| +| operations | [teamsAsyncOperation](teamsasyncoperation.md) collection | A collection of all the Teams async operations that ran or are running on the chat. Nullable. | +| pinnedMessages | [pinnedChatMessageInfo](pinnedchatmessageinfo.md) collection | A collection of all the pinned messages in the chat. Nullable. | | tabs | [teamsTab](teamstab.md) collection | A collection of all the tabs in the chat. Nullable. | ## JSON representation -Here is a JSON representation of the resource. +The following is a JSON representation of the resource. <!-- { "blockType": "resource", |
| v1.0 | Crosstenantaccesspolicy Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/crosstenantaccesspolicy-overview.md | For example, when you configure your trust settings to trust MFA, your MFA polic Inbound trust settings also enable you to trust devices that are compliant, or hybrid Azure AD joined in their home directories. With inbound trust settings in cross-tenant access settings, you can now protect access to your apps and resources by requiring that external users use compliant, or hybrid Azure AD joined devices. +## Collaborate with organizations using Azure Active Directory in different Microsoft clouds ++Cross-tenant access settings is used to enable collaboration with Azure AD organizations in separate Microsoft clouds. The `allowedCloudEndpoints` property enables you to specify which Microsoft clouds you'd like to extend your collaboration to. B2B collaboration is supported between the following Microsoft clouds: +++ Microsoft Azure commercial and Microsoft Azure Government++ Microsoft Azure commercial and Microsoft Azure China++<!Learn more about [collaborating with organizations from a different Microsoft cloud](azure/active-directory/external-identities/cross-cloud-settings).> + ## Interpreting the API response The cross-tenant access settings API can be used to set up multiple configurations for allowing or blocking access to and from your organization. The following table highlights scenarios, shows an example of the API response, and what the interpretation should be of that response. **b2bSetting** is used as a placeholder for any B2B inbound (**b2bCollaborationInbound** or **b2bDirectConnectInbound**) or outbound (**b2bCollaborationOutbound** or **b2bDirectConnectOutbound**) configuration. |
| v1.0 | Crosstenantaccesspolicy | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/crosstenantaccesspolicy.md | Inherits from [tenantRelationshipAccessPolicyBase](../resources/tenantrelationsh |Property|Type|Description| |:|:|:| | displayName | String | The display name of the cross-tenant access policy. Inherited from [policyBase](../resources/policybase.md).|+| allowedCloudEndpoints | String collection | Used to specify which Microsoft clouds an organization would like to collaborate with. By default, this value is empty. Supported values for this field are: `microsoftonline.com`, `microsoftonline.us`, and `partner.microsoftonline.cn`. | | definition (deprecated) | String | The raw JSON definition of the cross-tenant access policy. **Deprecated. Do not use.**| ## Relationships The following is a JSON representation of the resource. { "@odata.type": "#microsoft.graph.crossTenantAccessPolicy", "displayName": "String",- "definition": "String" + "definition": "String", + "allowedCloudEndpoints": ["String"] } ``` |
| v1.0 | Pinnedchatmessageinfo | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/pinnedchatmessageinfo.md | + + Title: "pinnedChatMessageInfo resource type" +description: "Represents an individual pinned message in a chat entity." ++ms.localizationpriority: medium +++# pinnedChatMessageInfo resource type ++Namespace: microsoft.graph +++Represents an individual pinned message in a [chat](chat.md). +++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List pinned messages in chat](../api/chat-list-pinnedmessages.md)|[pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md) collection|Get a list of pinned messages in a chat.| +|[Pin a message in chat](../api/chat-post-pinnedmessages.md)|[pinnedChatMessageInfo](../resources/pinnedchatmessageinfo.md)|Pin a chat message in a chat.| +|[Unpin a message from chat](../api/chat-delete-pinnedmessages.md)|None|Unpin a message from a chat.| ++## Properties +|Property|Type|Description| +|:|:|:| +| id| String| The ID of the [chatMessage](../resources/chatmessage.md). Read-only. | ++## Relationships +|Relationship|Type|Description| +|:|:|:| +| message | [chatMessage](../resources/chatmessage.md) | Represents details about the chat message that is pinned.| ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.pinnedChatMessageInfo", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.pinnedChatMessageInfo", + "id": "String (identifier)" +} +``` + |
| v1.0 | Tenantadmin Settings | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/tenantadmin-settings.md | + + Title: "settings resource type" +description: "Represents the tenant-level settings for SharePoint and OneDrive." ++ms.localizationpriority: medium +++# settings resource type +Namespace: microsoft.graph.tenantAdmin +++Represents the tenant-level settings for SharePoint and OneDrive. ++Inherits from [entity](../resources/entity.md). ++## Methods +|Method|Return type|Description +|:|:|: +|[Get settings](../api/tenantadmin-settings-get.md)|[microsoft.graph.tenantAdmin.settings](../resources/tenantadmin-settings.md) | Get the tenant-level settings for SharePoint and OneDrive.| +|[Update settings](../api/tenantadmin-settings-update.md) | [microsoft.graph.tenantAdmin.settings](../resources/tenantadmin-settings.md) | Update one or more tenant-level settings for SharePoint and OneDrive.| ++## Properties +|Property|Type|Description| +|:|:|:| +| allowedDomainGuidsForSyncApp | GUID collection | Collection of trusted domain GUIDs for the OneDrive sync app. | +| availableManagedPathsForSiteCreation | String collection | Collection of managed paths available for site creation. Read-only. | +| deletedUserPersonalSiteRetentionPeriodInDays | Int32 | The number of days for preserving a deleted user's OneDrive. | +| excludedFileExtensionsForSyncApp | String collection | Collection of file extensions not uploaded by the OneDrive sync app. | +| imageTaggingOption | [tenantAdmin.imageTaggingChoice](../resources/tenantadmin-settings.md#imagetaggingchoice-values) | Specifies the image tagging option for the tenant. Possible values are: `disabled`, `basic`, `enhanced`. | +| isCommentingOnSitePagesEnabled | Boolean | Indicates whether comments are allowed on modern site pages in SharePoint. | +| isFileActivityNotificationEnabled | Boolean | Indicates whether push notifications are enabled for OneDrive events. | +| isLoopEnabled | Boolean | Indicates whetherif Fluid Framework is allowed on SharePoint sites. | +| isMacSyncAppEnabled | Boolean | Indicates whether files can be synced using the OneDrive sync app for Mac. | +| isResharingByExternalUsersEnabled | Boolean | Indicates whether guests are allowed to reshare files, folders, and sites they don't own. | +| isSharePointMobileNotificationEnabled | Boolean | Indicates whether mobile push notifications are enabled for SharePoint. | +| isSharePointNewsfeedEnabled | Boolean | Indicates whether the newsfeed is allowed on the modern site pages in SharePoint. | +| isSiteCreationEnabled | Boolean | Indicates whether users are allowed to create sites. | +| isSiteCreationUIEnabled | Boolean | Indicates whether the UI commands for creating sites are shown. | +| isSitePagesCreationEnabled | Boolean | Indicates whether creating new modern pages is allowed on SharePoint sites. | +| isSitesStorageLimitAutomatic | Boolean | Indicates whether site storage space is automatically managed or if specific storage limits are set per site. | +| isSyncButtonHiddenOnPersonalSite | Boolean | Indicates whether the sync button in OneDrive is hidden. | +| isUnmanagedSyncAppForTenantRestricted | Boolean | Indicates whether users are allowed to sync files only on PCs joined to specific domains. | +| personalSiteDefaultStorageLimitInMB | Int64 | The default OneDrive storage limit for all new and existing users who are assigned a qualifying license. Measured in megabytes (MB). | +| sharingAllowedDomainList | String collection | Collection of email domains that are allowed for sharing outside the organization. | +| sharingBlockedDomainList | String collection | Collection of email domains that are blocked for sharing outside the organization. | +| sharingCapability | [tenantAdmin.sharingCapabilities](#sharingcapabilities-values) | Sharing capability for the tenant. Possible values are: `disabled`, `externalUserSharingOnly`, `externalUserAndGuestSharing`, `existingExternalUserSharingOnly`. | +| sharingDomainRestrictionMode | [tenantAdmin.sharingDomainRestrictionMode](#sharingdomainrestrictionmode-values) | Specifies the external sharing mode for domains. Possible values are: `none`, `allowList`, `blockList`. | +| siteCreationDefaultManagedPath | String | The value of the team site managed path. This is the path under which new team sites will be created. | +| siteCreationDefaultStorageLimitInMB | Int32 | The default storage quota for a new site upon creation. Measured in megabytes (MB). | +| tenantDefaultTimezone | String | The default timezone of a tenant for newly created sites. | ++### imageTaggingChoice values +| Member | Description | +| : | :| +| disabled | The image tagging option for the tenant is disabled. | +| basic | Allows users within the tenant to add basic tags to images to make them accessible through search. | +| enhanced | Allows users to tag images with custom tags and enhanced features. | +| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. | ++### sharingCapabilities values +| Member | Description | +| : | :| +| disabled | Users can share only with people in the organization. No external sharing is allowed. | +| externalUserSharingOnly | Users can share with new and existing guests. Guests must sign in or provide a verification code. | +| externalUserAndGuestSharing | Users can share with anyone by using links that don't require sign-in. | +| existingExternalUserSharingOnly | Users can share with existing guests (those already in the directory of the organization). | +| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. | ++### sharingDomainRestrictionMode values +| Member | Description | +||--| +| none | No restrictions apply. | +| allowList | Users will be able to share with external collaborators coming only from the list of allowed email domains. | +| blockList | Users will be able to share with all external collaborators apart from the ones on the list of blocked email domains. | +| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. | ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.tenantAdmin.settings", + "openType": "false" +} +--> +``` json +{ + "allowedDomainGuidsForSyncApp": ["string (identifier)"], + "availableManagedPathsForSiteCreation": ["string"], + "deletedUserPersonalSiteRetentionPeriodInDays": "Int32", + "excludedFileExtensionsForSyncApp": ["string"], + "id": "string (identifier)", + "imageTaggingOption": "string", + "isCommentingOnSitePagesEnabled": "boolean", + "isFileActivityNotificationEnabled": "boolean", + "isLoopEnabled": "boolean", + "isMacSyncAppEnabled": "boolean", + "isResharingByExternalUsersEnabled": "boolean", + "isSharePointMobileNotificationEnabled": "boolean", + "isSharePointNewsfeedEnabled": "boolean", + "isSiteCreationEnabled": "boolean", + "isSiteCreationUIEnabled": "boolean", + "isSitePagesCreationEnabled": "boolean", + "isSitesStorageLimitAutomatic": "boolean", + "isSyncButtonHiddenOnPersonalSite": "boolean", + "isUnmanagedSyncAppForTenantRestricted": "boolean", + "personalSiteDefaultStorageLimitInMB": "Int64", + "sharingAllowedDomainList" : ["string"], + "sharingBlockedDomainList" : ["string"], + "sharingCapability": "string", + "sharingDomainRestrictionMode": "string", + "siteCreationDefaultManagedPath": "string", + "siteCreationDefaultStorageLimitInMB": "Int32", + "tenantDefaultTimezone": "string" +} +``` ++<!-- +{ + "type": "#page.annotation", + "description": "settings resource", + "keywords": "", + "section": "documentation", + "tocPath": "", + "namespace": "microsoft.graph.tenantAdmin" +} +--> |
| v1.0 | Tenantadmin Sharepoint | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/tenantadmin-sharepoint.md | + + Title: "sharepoint resource type" +description: "Represents a container for administrative resources to manage tenant-level settings for SharePoint and OneDrive." ++ms.localizationpriority: medium +++# sharepoint resource type ++Namespace: microsoft.graph.tenantAdmin +++Represents a container for administrative resources to manage tenant-level settings for SharePoint and OneDrive. ++## Properties +None. ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|settings|[microsoft.graph.tenantAdmin.settings](../resources/tenantadmin-settings.md)|Represents the tenant-level settings for SharePoint and OneDrive.| ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.tenantAdmin.sharepoint", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.tenantAdmin.sharepoint" +} +``` + |
| v1.0 | Reportroot Getemailactivitycounts | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/reportroot-getemailactivitycounts.md | The CSV file has the following headers for columns. - Send - Receive - Read+- Meeting Created +- Meeting Interacted - Report Date - Report Period Follow the 302 redirection and the CSV file that downloads will have the followi HTTP/1.1 200 OK Content-Type: application/octet-stream -Report Refresh Date,Send,Receive,Read,Report Date,Report Period +Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> |
| v1.0 | Reportroot Getemailactivityusercounts | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/reportroot-getemailactivityusercounts.md | The CSV file has the following headers for columns. - Send - Receive - Read+- Meeting Created +- Meeting Interacted - Report Date - Report Period Follow the 302 redirection and the CSV file that downloads will have the followi HTTP/1.1 200 OK Content-Type: application/octet-stream -Report Refresh Date,Send,Receive,Read,Report Date,Report Period +Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> |
| v1.0 | Reportroot Getemailactivityuserdetail | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/reportroot-getemailactivityuserdetail.md | The CSV file has the following headers for columns. - Send Count - Receive Count - Read Count+- Meeting Created Count +- Meeting Interacted Count - Assigned Products - Report Period Follow the 302 redirection and the CSV file that downloads will have the followi HTTP/1.1 200 OK Content-Type: application/octet-stream -Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Last Activity Date,Send Count,Receive Count,Read Count,Assigned Products,Report Period +Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Last Activity Date,Send Count,Receive Count,Read Count,Meeting Created Count,Meeting Interacted Count,Assigned Products,Report Period ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> |
| v1.0 | User Exportpersonaldata | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-exportpersonaldata.md | doc_type: apiPageType Namespace: microsoft.graph -Submit a data policy operation request from a company administrator or an application to export an organizational user's data. +Submit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's data stored in OneDrive and their activity reports. For more guidance about exporting data while complying with regulations, see [Data Subject Requests and the GDPR and CCPA](/compliance/regulatory/gdpr-data-subject-requests). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
| v1.0 | Link Validation Config.Json | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/config/link-validation-config.json | a/api-reference/v1.0/config/link-validation-config.json "pathsToIgnore": [ "/aspnet", "/azure", + "/compliance", "/cloud-app-security", "/defender-for-identity", "/dotnet", |
| v1.0 | Plannerplancontainer | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/plannerplancontainer.md | Microsoft Planner currently supports the container types listed in the following |Type|Description|Path to the resource| |-|--|--| |group| Plan is contained by a [group](group.md).| https://graph.microsoft.com/v1.0/groups/{id}|-|roster| Plan is contained by a **plannerRoster** | https://graph.microsoft.com/beta/planner/rosters/{id}. **plannerRosters** are currently only accessible using the beta version.| +|roster| Plan is contained by a **plannerRoster** | https://graph.microsoft.com/beta/planner/rosters/{id}. Rosters as containers for plans (**plannerRoster** resources) are currently accessible only through the beta endpoint.| ## Properties |Property|Type|Description| |