Merging changes synced from https://github.com/microsoftgraph/microso…

…ft-graph-docs (branch live)
microsoftgraph · Jan 31, 2025 · bb2fde0 · bb2fde0
2 parents c73f6ce + 9d1298c
commit bb2fde0
Show file tree

Hide file tree

Showing 104 changed files with 816 additions and 366 deletions.
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -3,6 +3,7 @@
         "main",
         "main",
         "main",
+        "main",
         "main"
     ],
     "json.schemas": [

diff --git a/README.md b/README.md
@@ -4,8 +4,6 @@ Thank you for your interest in Microsoft Graph documentation! For the best exper
 
 ## Give us your feedback
 
-**Coming soon:** In March 2024, we will be phasing out the current feedback mechanism for content (GitHub issues) described below and replacing it with a new feedback system. For more information, see https://aka.ms/ContentUserFeedback.
-
 Your feedback is important to us.
 
 - To let us know about any questions or issues you find in the documentation, [leave feedback using the standard experience](https://learn.microsoft.com/en-us/contribute/content/provide-feedback#use-the-standard-experience).

diff --git a/api-reference/beta/api/chatmessage-get.md b/api-reference/beta/api/chatmessage-get.md
@@ -73,7 +73,7 @@ Don't supply a request body for this method.
 
 ## Response
 
-If successful, this method returns a `200 OK` response code and a [chatmessage](../resources/chatmessage.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [chatMessage](../resources/chatmessage.md) object in the response body.
 
 ## Examples
 
@@ -589,7 +589,7 @@ GET https://graph.microsoft.com/beta/chats/19:80a7ff67c0ef43c19d88a7638be436b1@t
 
 #### Response
 
-The following example shows the response. The message body contains an @mention for everyone in a group chat that is represented by the `<at></at>` tag. The **conversationIdentityType** property is set to `chat` in the **conversation** identity of the **mentioned** object.
+The following example shows the response. The message body contains `<at></at>` tags for each @mention of everyone in a group chat. The **conversationIdentityType** property is set to `chat` in the **conversation** identity of the **mentioned** object.
 
 <!-- {
   "blockType": "response",
@@ -777,6 +777,102 @@ Content-type: application/json
 }
 ```
 
+### Example 7: Get a chat message with a Microsoft Loop component
+
+The following example shows a request that gets a chat message that has a Loop component as two attachments. 
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "get_chatmessage_7",
+  "sampleKeys": ["19:[email protected]", "1732043970539"]
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/chats/19:[email protected]/messages/1732043970539
+```
+
+
+
+#### Response
+
+The following example shows the response. The message body contains two attachments. The value of the **contentType** property of the Loop component is `application/vnd.microsoft.card.fluidEmbedCard`, and the value of the **contentType** property of the placeholder card is `application/vnd.microsoft.card.codesnippet`. 
+
+> **Note**  - The **contentUrl** and **content** properties for a placeholder card don't have values.
+
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "microsoft.graph.chatMessage"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3Ae2ed97baac8e4bffbb91299a38996790%40thread.v2')/messages/$entity",
+    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET chats('<key>')/messages('<key>')?$select=attachments,body",
+    "id": "1732043970539",
+    "replyToId": null,
+    "etag": "1732043970539",
+    "messageType": "message",
+    "createdDateTime": "2024-11-19T19:19:30.539Z",
+    "lastModifiedDateTime": "2024-11-19T19:19:30.539Z",
+    "lastEditedDateTime": null,
+    "deletedDateTime": null,
+    "subject": null,
+    "summary": null,
+    "chatId": "19:[email protected]",
+    "importance": "normal",
+    "locale": "en-us",
+    "webUrl": null,
+    "channelIdentity": null,
+    "onBehalfOf": null,
+    "policyViolation": null,
+    "eventDetail": null,
+    "from": {
+        "application": null,
+        "device": null,
+        "user": {
+            "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+            "id": "28c10244-4bad-4fda-993c-f332faef94f0",
+            "displayName": null,
+            "userIdentityType": "aadUser",
+            "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
+        }
+    },
+    "body": {
+        "contentType": "html",
+        "content": "<attachment id=\"placeholderCard\"></attachment><span style=\"display:none\"></span><attachment id=\"b21e256a-8581-45cf-ae05-8bb998360bcc\"></attachment>"
+    },
+    "attachments": [
+        {
+            "id": "b21e256a-8581-45cf-ae05-8bb998360bcc",
+            "contentType": "application/vnd.microsoft.card.fluidEmbedCard",
+            "contentUrl": null,
+            "content": "{\r\n  \"componentUrl\": \"https://teamsgraph-my.sharepoint.com/:fl:/g/personal/sumanac_teamsgraph_onmicrosoft_com/EQnofOQM0MpOoDaRIvw-pS8Bfsj_WDFuanBBXnjDAD-w3g?nav=cz0lMkZwZXJzb25hbCUyRnN1bWFuYWNfdGVhbXNncmFwaF9vbm1pY3Jvc29mdF9jb20mZD1iIWVUcmxYX19jN2t5eW9GSFhJdG8yTDI4bmtnV2EtOXhEa244SVBOdGZFYnlxandPblkwdE9TcFVldkh6dWtBV1ImZj0wMUU2TzQ0WFlKNUI2T0lER1FaSkhLQU5VUkVMNkQ1SkpQJmM9JTJGJmZsdWlkPTEmYT1UZWFtcyZwPSU0MGZsdWlkeCUyRmxvb3AtcGFnZS1jb250YWluZXI%3D\",\r\n  \"sourceType\": \"Compose\"\r\n}",
+            "name": null,
+            "thumbnailUrl": null,
+            "teamsAppId": "FluidEmbedCard"
+        },
+        {
+            "id": "placeholderCard",
+            "contentType": "application/vnd.microsoft.card.codesnippet",
+            "contentUrl": null,
+            "content": "{}",
+            "name": null,
+            "thumbnailUrl": null,
+            "teamsAppId": "FLUID_PLACEHOLDER_CARD"
+        }
+    ],
+    "mentions": [],
+    "reactions": []
+}
+```
+
 ## Related content
 
 - [List messages in a channel](channel-list-messages.md)

diff --git a/api-reference/beta/api/mailbox-createimportsession.md b/api-reference/beta/api/mailbox-createimportsession.md
@@ -20,11 +20,7 @@ Create a session to [import an Exchange mailbox item](/graph/import-exchange-mai
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-createimportsession-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_createimportsession" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-createimportsession-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailbox-delete-folders.md b/api-reference/beta/api/mailbox-delete-folders.md
@@ -20,11 +20,7 @@ Delete a [mailboxFolder](../resources/mailboxfolder.md) or a child **mailboxFold
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-delete-folders-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_delete_folders" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-delete-folders-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailbox-exportitems.md b/api-reference/beta/api/mailbox-exportitems.md
@@ -22,11 +22,7 @@ You can export up to 20 items in a single export request.
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-exportitems-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_exportitems" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-exportitems-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailbox-list-folders.md b/api-reference/beta/api/mailbox-list-folders.md
@@ -20,11 +20,7 @@ Get all the [mailboxFolder](../resources/mailboxfolder.md) objects in the specif
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-list-folders-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_list_folders" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-list-folders-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailbox-post-folders.md b/api-reference/beta/api/mailbox-post-folders.md
@@ -20,11 +20,7 @@ Create a new [mailboxFolder](../resources/mailboxfolder.md) or child **mailboxFo
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-post-folders-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_post_folders" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-post-folders-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailboxfolder-delta.md b/api-reference/beta/api/mailboxfolder-delta.md
@@ -22,11 +22,7 @@ A **delta** function call for folders in a mailbox is similar to a GET request,
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-delta-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_delta" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-delta-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailboxfolder-get.md b/api-reference/beta/api/mailboxfolder-get.md
@@ -20,11 +20,7 @@ Read the properties and relationships of a [mailboxFolder](../resources/mailboxf
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-get-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_get" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-get-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailboxfolder-list-items.md b/api-reference/beta/api/mailboxfolder-list-items.md
@@ -20,11 +20,7 @@ Get the [mailboxItem](../resources/mailboxitem.md) collection within a specified
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-list-items-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_list_items" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-list-items-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailboxfolder-update.md b/api-reference/beta/api/mailboxfolder-update.md
@@ -23,11 +23,7 @@ Update [mailboxFolder](../resources/mailboxfolder.md) properties such as the **d
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-update-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_update" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-update-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailboxitem-delta.md b/api-reference/beta/api/mailboxitem-delta.md
@@ -22,11 +22,7 @@ A **delta** function call for items in a folder is similar to a GET request, exc
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxitem-delta-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxitem_delta" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxitem-delta-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/mailboxitem-get.md b/api-reference/beta/api/mailboxitem-get.md
@@ -20,11 +20,7 @@ Read the properties and relationships of a [mailboxItem](../resources/mailboxite
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxitem-get-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxitem_get" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxitem-get-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/opentypeextension-delete.md b/api-reference/beta/api/opentypeextension-delete.md
@@ -40,7 +40,7 @@ Depending on the resource you're deleting the extension from and the permission
 | [personal contact](../resources/contact.md) | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
 | [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
 | [todoTasklist](../resources/todotasklist.md)  | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
-| [user](../resources/user.md) | User.ReadWrite | User.ReadWrite | User.ReadWrite.All |
+| [user](../resources/user.md) | User.ReadWrite | Not supported | User.ReadWrite.All |
 
 ## HTTP request
 

diff --git a/api-reference/beta/api/opentypeextension-get.md b/api-reference/beta/api/opentypeextension-get.md
@@ -48,7 +48,7 @@ Depending on the resource that contains the extension and the permission type (d
 | [personal contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read |
 | [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
 | [todoTaskList](../resources/todotasklist.md)  | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
-| [user](../resources/user.md) | User.Read | User.Read | User.Read.All |
+| [user](../resources/user.md) | User.Read | Not supported | User.Read.All |
 
 ## HTTP request
 

diff --git a/api-reference/beta/api/opentypeextension-post-opentypeextension.md b/api-reference/beta/api/opentypeextension-post-opentypeextension.md
@@ -40,7 +40,7 @@ Depending on the resource you're creating the extension in and the permission ty
 | [personal contact](../resources/contact.md) | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
 | [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
 | [todoTaskList](../resources/todotasklist.md)  | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
-| [user](../resources/user.md) | User.ReadWrite | User.ReadWrite | User.ReadWrite.All |
+| [user](../resources/user.md) | User.ReadWrite | Not supported | User.ReadWrite.All |
 | [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
 | [baseTaskList](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
 <!--

diff --git a/api-reference/beta/api/opentypeextension-update.md b/api-reference/beta/api/opentypeextension-update.md
@@ -44,7 +44,7 @@ Depending on the resource that the extension was created in and the permission t
 | [personal contact](../resources/contact.md) | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
 | [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
 | [todoTasklist](../resources/todotasklist.md)  | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
-| [user](../resources/user.md) | User.ReadWrite | User.ReadWrite | User.ReadWrite.All |
+| [user](../resources/user.md) | User.ReadWrite | Not supported | User.ReadWrite.All |
 
 ## HTTP request
 

diff --git a/api-reference/beta/api/subscription-delete.md b/api-reference/beta/api/subscription-delete.md
@@ -29,6 +29,8 @@ Depending on the resource and the permission type (delegated or application) req
 
 | Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
 |:-----|:-----|:-----|:-----|
+|[aiInteraction](../resources/aiinteraction.md)  <br /> `copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions`  <br /> Copilot AI interactions that a particular user is part of. | AiEnterpriseInteraction.Read  | Not supported.  | AiEnterpriseInteraction.Read.All, AiEnterpriseInteraction.Read.User  |
+|[aiInteraction](../resources/aiinteraction.md)  <br /> `copilot/interactionHistory/getAllEnterpriseInteractions`  <br /> Copilot AI interactions in an organization. | Not supported.  | Not supported.  | AiEnterpriseInteraction.Read.All  |
 |[approvalItems](../resources/approvalItem.md) | Not supported.  | Not supported.  | ApprovalSolution.ReadWrite.All  |
 |[callRecord](../resources/callrecords-callrecord.md) | Not supported. | Not supported. | CallRecords.Read.All  |
 |[callRecording](../resources/callrecording.md) <br /> `communications/onlineMeetings/getAllRecordings` <br /> Any recording becomes available in the tenant. | Not supported. | Not supported. | OnlineMeetingRecording.Read.All |
@@ -92,9 +94,13 @@ Depending on the resource and the permission type (delegated or application) req
 > - Chat.Manage.Chat
 > - ChannelMessage.Read.Group
 > - ChatMember.Read.Chat
+> - AiEnterpriseInteraction.Read.User
 
 [!INCLUDE [teams-subscription-notes](../../includes/teams-subscription-notes.md)]
 
+<!-- ### aiInteraction -->
+[!INCLUDE [copilot-aiinteraction-subscription-notes.md](../../includes/copilot-aiinteraction-subscription-notes.md)]
+
 ### driveItem
 
 More limitations apply to subscriptions on OneDrive items. The limitations apply to creating as well as managing (getting, updating, and deleting) subscriptions.
-Original file line number
+Diff line change
@@ Expand Up / @@ -3,6 +3,7 @@ @@
             "main",
             "main",
             "main",
+            "main",
             "main"
         ],
         "json.schemas": [
@@ Expand Down @@