Skip to content

Commit c579112

Browse files
OWinfreyATLOWinfreyATL
authored
Merge branch 'main' into owinfreyATL-TermsOfUse-Notes
2 parents 3703ce3 + b39e878 commit c579112

File tree

188 files changed

+5816
-575
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

188 files changed

+5816
-575
lines changed

‎.vscode/settings.json

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
"main",
44
"main",
55
"main",
6+
"main",
67
"main"
78
],
89
"json.schemas": [
@@ -17,6 +18,12 @@
1718
"cloud.exclusions.json"
1819
],
1920
"url": "https://raw.githubusercontent.com/microsoftgraph/msgraph-cloud-support/main/schema/cloud.exclusions.schema.json"
20-
}
21+
},
22+
{
23+
"fileMatch": [
24+
"toc.mapping.json"
25+
],
26+
"url": "https://raw.githubusercontent.com/microsoftgraph/msgraph-toc-gen/main/schema/toc.mapping.schema.json"
27+
}
2128
]
2229
}

‎README.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,6 @@ Thank you for your interest in Microsoft Graph documentation! For the best exper
44

55
## Give us your feedback
66

7-
**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.
8-
97
Your feedback is important to us.
108

119
- 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).

‎api-reference/beta/api/chatmessage-get.md

Lines changed: 98 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Don't supply a request body for this method.
7373

7474
## Response
7575

76-
If successful, this method returns a `200 OK` response code and a [chatmessage](../resources/chatmessage.md) object in the response body.
76+
If successful, this method returns a `200 OK` response code and a [chatMessage](../resources/chatmessage.md) object in the response body.
7777

7878
## Examples
7979

@@ -589,7 +589,7 @@ GET https://graph.microsoft.com/beta/chats/19:80a7ff67c0ef43c19d88a7638be436b1@t
589589

590590
#### Response
591591

592-
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.
592+
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.
593593

594594
<!-- {
595595
"blockType": "response",
@@ -777,6 +777,102 @@ Content-type: application/json
777777
}
778778
```
779779

780+
### Example 7: Get a chat message with a Microsoft Loop component
781+
782+
The following example shows a request that gets a chat message that has a Loop component as two attachments.
783+
784+
#### Request
785+
786+
The following example shows a request.
787+
788+
<!-- {
789+
"blockType": "request",
790+
"name": "get_chatmessage_7",
791+
"sampleKeys": ["19:e2ed97baac8e4bffbb91299a38996790@thread.v2", "1732043970539"]
792+
}-->
793+
```msgraph-interactive
794+
GET https://graph.microsoft.com/beta/chats/19:e2ed97baac8e4bffbb91299a38996790@thread.v2/messages/1732043970539
795+
```
796+
797+
798+
799+
#### Response
800+
801+
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`.
802+
803+
> **Note** - The **contentUrl** and **content** properties for a placeholder card don't have values.
804+
805+
<!-- {
806+
"blockType": "response",
807+
"truncated": true,
808+
"@odata.type": "microsoft.graph.chatMessage"
809+
} -->
810+
811+
```http
812+
HTTP/1.1 200 OK
813+
Content-type: application/json
814+
815+
{
816+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3Ae2ed97baac8e4bffbb91299a38996790%40thread.v2')/messages/$entity",
817+
"@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",
818+
"id": "1732043970539",
819+
"replyToId": null,
820+
"etag": "1732043970539",
821+
"messageType": "message",
822+
"createdDateTime": "2024-11-19T19:19:30.539Z",
823+
"lastModifiedDateTime": "2024-11-19T19:19:30.539Z",
824+
"lastEditedDateTime": null,
825+
"deletedDateTime": null,
826+
"subject": null,
827+
"summary": null,
828+
"chatId": "19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
829+
"importance": "normal",
830+
"locale": "en-us",
831+
"webUrl": null,
832+
"channelIdentity": null,
833+
"onBehalfOf": null,
834+
"policyViolation": null,
835+
"eventDetail": null,
836+
"from": {
837+
"application": null,
838+
"device": null,
839+
"user": {
840+
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
841+
"id": "28c10244-4bad-4fda-993c-f332faef94f0",
842+
"displayName": null,
843+
"userIdentityType": "aadUser",
844+
"tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
845+
}
846+
},
847+
"body": {
848+
"contentType": "html",
849+
"content": "<attachment id=\"placeholderCard\"></attachment><span style=\"display:none\"></span><attachment id=\"b21e256a-8581-45cf-ae05-8bb998360bcc\"></attachment>"
850+
},
851+
"attachments": [
852+
{
853+
"id": "b21e256a-8581-45cf-ae05-8bb998360bcc",
854+
"contentType": "application/vnd.microsoft.card.fluidEmbedCard",
855+
"contentUrl": null,
856+
"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}",
857+
"name": null,
858+
"thumbnailUrl": null,
859+
"teamsAppId": "FluidEmbedCard"
860+
},
861+
{
862+
"id": "placeholderCard",
863+
"contentType": "application/vnd.microsoft.card.codesnippet",
864+
"contentUrl": null,
865+
"content": "{}",
866+
"name": null,
867+
"thumbnailUrl": null,
868+
"teamsAppId": "FLUID_PLACEHOLDER_CARD"
869+
}
870+
],
871+
"mentions": [],
872+
"reactions": []
873+
}
874+
```
875+
780876
## Related content
781877

782878
- [List messages in a channel](channel-list-messages.md)

‎api-reference/beta/api/mailbox-createimportsession.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: "mailbox: createImportSession"
3+
description: "Create a session to import an Exchange mailbox item using its FastTransfer stream (FTS) format."
4+
author: "cparker-msft"
5+
ms.date: 12/06/2024
6+
ms.localizationpriority: medium
7+
ms.subservice: "outlook"
8+
doc_type: apiPageType
9+
---
10+
11+
# mailbox: createImportSession
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Create a session to [import an Exchange mailbox item](/graph/import-exchange-mailbox-item) using its [FastTransfer stream](/openspecs/exchange_server_protocols/ms-oxcfxics/a2648823-0a98-43ee-98e8-590e4f7bcbbe) (FTS) format.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- { "blockType": "permissions", "name": "mailbox_createimportsession" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/mailbox-createimportsession-permissions.md)]
25+
26+
## HTTP request
27+
28+
<!-- {
29+
"blockType": "ignored"
30+
}
31+
-->
32+
``` http
33+
POST /admin/exchange/mailboxes/{mailboxId}/createImportSession
34+
```
35+
36+
## Request headers
37+
38+
|Name|Description|
39+
|:---|:---|
40+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
41+
42+
## Request body
43+
44+
Don't supply a request body for this method.
45+
46+
## Response
47+
48+
If successful, this action returns a `200 OK` response code and a [mailboxItemImportSession](../resources/mailboxitemimportsession.md) in the response body.
49+
50+
## Examples
51+
52+
### Request
53+
54+
The following example shows how to create an import session. The opaque URL, returned in the **importUrl** property of the response, is preauthenticated and contains the appropriate authorization token for subsequent POST queries in the https://outlook.office365.com domain. That token expires by **expirationDateTime**. Don't customize this URL for subsequent POST operations.
55+
56+
<!-- {
57+
"blockType": "request",
58+
"name": "mailboxthis.createimportsession",
59+
"sampleKeys": ["MBX:e0643f21@a7809c93"]
60+
}
61+
-->
62+
``` http
63+
POST https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/createImportSession
64+
```
65+
66+
### Response
67+
68+
The following example shows the response.
69+
>**Note:** The response object shown here might be shortened for readability.
70+
<!-- {
71+
"blockType": "response",
72+
"truncated": true,
73+
"@odata.type": "microsoft.graph.mailboxItemImportSession"
74+
}
75+
-->
76+
``` http
77+
HTTP/1.1 200 OK
78+
Content-type: application/json
79+
Content-length: 232
80+
81+
{
82+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.mailboxItemImportSession",
83+
"importUrl": "https://outlook.office365.com/api/gbeta/Mailboxes('MBX:e0643f21@a7809c93')/importItem?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IjFTeXQ1b",
84+
"expirationDateTime": "2024-10-17T19:00:48.1052906Z"
85+
}
86+
```

‎api-reference/beta/api/mailbox-delete-folders.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
title: "Delete mailboxFolder"
3+
description: "Delete a mailboxFolder or a child mailboxFolder within a mailbox."
4+
author: "cparker-msft"
5+
ms.date: 12/06/2024
6+
ms.localizationpriority: medium
7+
ms.subservice: "outlook"
8+
doc_type: apiPageType
9+
---
10+
11+
# Delete mailboxFolder
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Delete a [mailboxFolder](../resources/mailboxfolder.md) or a child **mailboxFolder** within a mailbox.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- { "blockType": "permissions", "name": "mailbox_delete_folders" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/mailbox-delete-folders-permissions.md)]
25+
26+
## HTTP request
27+
28+
<!-- {
29+
"blockType": "ignored"
30+
}
31+
-->
32+
``` http
33+
DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/$ref
34+
DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId}/$ref
35+
```
36+
37+
## Request headers
38+
39+
|Name|Description|
40+
|:---|:---|
41+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
42+
43+
## Request body
44+
45+
Don't supply a request body for this method.
46+
47+
## Response
48+
49+
If successful, this method returns a `204 No Content` response code.
50+
51+
## Examples
52+
53+
### Request
54+
55+
The following example shows how to delete a mailbox folder.
56+
<!-- {
57+
"blockType": "request",
58+
"name": "delete_mailboxfolder",
59+
"sampleKeys": ["MBX:e0648f21@aab09c93", "AAMkAGVmMDEzM"]
60+
}
61+
-->
62+
``` http
63+
DELETE https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/AAMkAGVmMDEzM/$ref
64+
```
65+
66+
### Response
67+
68+
The following example shows the response.
69+
70+
<!-- {
71+
"blockType": "response",
72+
"truncated": true
73+
}
74+
-->
75+
``` http
76+
HTTP/1.1 204 No Content
77+
```

0 commit comments

Comments
 (0)