Skip to content

Commit 7399bf3

Browse files
DanipocketDanipocket
authored
Merge pull request #28067 from microsoftgraph/user/aditysharma/replyWithQuote-beta-upgrade-to-v1.0-documentation-addition
Added documentation for transitioning Beta API to V1.0.
2 parents 8d44c36 + 75a3c2e commit 7399bf3

6 files changed

Lines changed: 191 additions & 0 deletions

File tree

‎api-reference/v1.0/api/chatmessage-replywithquote.md‎

Lines changed: 155 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,155 @@
1+
---
2+
title: "chatMessage: replyWithQuote"
3+
description: "Reply with quote to a single chat message or multiple chat messages in a chat."
4+
author: "AdityaSharma6"
5+
ms.subservice: "teams"
6+
doc_type: apiPageType
7+
ms.localizationpriority: medium
8+
ms.date: 02/20/2025
9+
---
10+
11+
# chatMessage: replyWithQuote
12+
13+
Namespace: microsoft.graph
14+
15+
Reply with quote to a single [chat message](../resources/chatmessage.md) or multiple chat messages in a [chat](../resources/chat.md).
16+
17+
> [!NOTE]
18+
> When replying with a quote to multiple messages, a maximum of 10 messages can be used for the reply.
19+
20+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
21+
22+
## Permissions
23+
24+
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).
25+
26+
<!-- { "blockType": "permissions", "name": "chatmessage_replywithquote" } -->
27+
[!INCLUDE [permissions-table](../includes/permissions/chatmessage-replywithquote-permissions.md)]
28+
29+
## HTTP request
30+
31+
<!-- {
32+
"blockType": "ignored"
33+
}
34+
-->
35+
```http
36+
POST /chats/{chatId}/messages/replyWithQuote
37+
```
38+
39+
## Request headers
40+
41+
|Name|Description|
42+
|:---|:---|
43+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
44+
|Content-Type|application/json. Required.|
45+
46+
## Request body
47+
48+
In the request body, supply a JSON representation of the parameters.
49+
50+
The following table shows the parameters that can be used with this action.
51+
52+
|Parameter|Type|Description|
53+
|:---|:---|:---|
54+
|messageIds|String collection|List of message IDs in a chat that are replied to with a quote. |
55+
|replyMessage|[chatMessage](../resources/chatmessage.md)|The message body for the reply. |
56+
57+
## Response
58+
59+
If successful, this method returns a `201 Created` response code and a new [chatMessage](../resources/chatmessage.md) object in the response body.
60+
61+
## Examples
62+
63+
### Request
64+
65+
The following example shows a request.
66+
67+
<!-- {
68+
"blockType": "request",
69+
"name": "chatmessage.replyWithQuote",
70+
"sampleKeys": ["19:97641583cf154265a237da28ebbde27a@thread.v2"]
71+
}
72+
-->
73+
```http
74+
POST https://graph.microsoft.com/v1.0/chats/19:97641583cf154265a237da28ebbde27a@thread.v2/messages/replyWithQuote
75+
Content-Type: application/json
76+
77+
{
78+
"messageIds": [
79+
"1728088338580"
80+
],
81+
"replyMessage": {
82+
"body": {
83+
"content": "Hello World"
84+
}
85+
}
86+
}
87+
```
88+
---
89+
90+
### Response
91+
92+
The following example shows the response.
93+
94+
>**Note:** The response object shown here might be shortened for readability.
95+
<!-- {
96+
"blockType": "response",
97+
"truncated": true,
98+
"@odata.type": "microsoft.graph.chatMessage"
99+
}
100+
-->
101+
```http
102+
HTTP/1.1 201 Created
103+
Content-type: application/json
104+
105+
{
106+
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A97641583cf154265a237da28ebbde27a%40thread.v2')/messages/$entity",
107+
"@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",
108+
"id": "1729091934196",
109+
"replyToId": null,
110+
"etag": "1729091934196",
111+
"messageType": "message",
112+
"createdDateTime": "2024-10-16T15:18:54.196Z",
113+
"lastModifiedDateTime": "2024-10-16T15:18:54.196Z",
114+
"lastEditedDateTime": null,
115+
"deletedDateTime": null,
116+
"subject": null,
117+
"summary": null,
118+
"chatId": "19:97641583cf154265a237da28ebbde27a@thread.v2",
119+
"importance": "normal",
120+
"locale": "en-us",
121+
"webUrl": null,
122+
"channelIdentity": null,
123+
"policyViolation": null,
124+
"eventDetail": null,
125+
"from": {
126+
"application": null,
127+
"device": null,
128+
"user": {
129+
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
130+
"id": "28c10244-4bad-4fda-993c-f332faef94f0",
131+
"displayName": "Adele Vance",
132+
"userIdentityType": "aadUser",
133+
"tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
134+
}
135+
},
136+
"body": {
137+
"contentType": "html",
138+
"content": "<p></p>\n<attachment id=\"1728422677844\"></attachment>\ntest reply\n<p></p>"
139+
},
140+
"attachments": [
141+
{
142+
"id": "1728422677844",
143+
"contentType": "messageReference",
144+
"contentUrl": null,
145+
"content": "{\"messageId\":\"1728422677844\",\"messagePreview\":\"Hello World Jane Smith\",\"messageSender\":{\"application\":null,\"device\":null,\"user\":{\"userIdentityType\":\"aadUser\",\"tenantId\":\"2432b57b-0abd-43db-aa7b-16eadd115d34\",\"id\":\"28c10244-4bad-4fda-993c-f332faef94f0\",\"displayName\":\"Adele Vance\"}}}",
146+
"name": null,
147+
"thumbnailUrl": null,
148+
"teamsAppId": null
149+
}
150+
],
151+
"mentions": [],
152+
"reactions": []
153+
}
154+
```
155+

‎api-reference/v1.0/includes/permissions/chatmessage-replywithquote-permissions.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
description: "Automatically generated file. DO NOT MODIFY"
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|ChatMessage.Send|Not available.|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|Not supported.|Not supported.|

‎api-reference/v1.0/resources/chatmessage.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,7 @@ Represents an individual chat message within a [channel](channel.md) or [chat](c
5252
|[Undo the deletion of a message in chat](../api/chatmessage-undosoftdelete.md)|[chatMessage](chatmessage.md)| Undelete the message in a chat.|
5353
|[Set reaction to a message in channel](../api/chatmessage-setreaction.md)|None| Set reaction to a message in a channel.|
5454
|[Unset reaction to a message in channel](../api/chatmessage-unsetreaction.md)|None| Unset reaction to a message in a channel.|
55+
|[Reply with quote](../api/chatmessage-replywithquote.md)|[chatMessage](chatmessage.md)|Reply with quote to a single [chat message](../resources/chatmessage.md) or multiple chat messages in a [chat](../resources/chat.md).
5556
|**Hosted content**| | |
5657
|[List all hosted content](../api/chatmessage-list-hostedcontents.md) | [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) collection| Get all hosted contents associated with a message.|
5758
|[Get hosted content](../api/chatmessagehostedcontent-get.md) | [chatMessageHostedContent](../resources/chatmessagehostedcontent.md) | Get hosted content (and its bytes) for a message.|

‎api-reference/v1.0/toc/teamwork-and-communications/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -805,6 +805,8 @@ items:
805805
href: ../../api/chatmessage-setreaction.md
806806
- name: Unset reaction to a message in channel
807807
href: ../../api/chatmessage-unsetreaction.md
808+
- name: Reply with quote
809+
href: ../../api/chatmessage-replywithquote.md
808810
- name: Hosted content
809811
items:
810812
- name: List all hosted content

‎changelog/Microsoft.Teams.GraphSvc.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,23 @@
11
{
22
"changelog": [
3+
{
4+
"ChangeList": [
5+
{
6+
"Id": "f8c2d4a1-9e7b-4f3c-a526-8d1e0b9f7c62",
7+
"ApiChange": "Method",
8+
"ChangedApiName": "replyWithQuote",
9+
"ChangeType": "Addition",
10+
"Description": "Added the [replyWithQuote](https://learn.microsoft.com/en-us/graph/api/chatmessage-replywithquote?view=graph-rest-v1.0) method to the [chatMessage](https://learn.microsoft.com/en-us/graph/api/resources/chatMessage?view=graph-rest-v1.0) resource.",
11+
"Target": "chatMessage"
12+
}
13+
],
14+
"Id": "f8c2d4a1-9e7b-4f3c-a526-8d1e0b9f7c62",
15+
"Cloud": "Prod",
16+
"Version": "v1.0",
17+
"CreatedDateTime": "2026-02-26T19:30:25.6008288Z",
18+
"WorkloadArea": "Teamwork and communications",
19+
"SubArea": "Messaging"
20+
},
321
{
422
"ChangeList": [
523
{

‎concepts/whats-new-overview.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,6 +179,10 @@ Use the **reportFileMetadata** property on [ediscoveryPurgeDataOperation](/graph
179179

180180
The `TeamsAppInstallation.ManageSelectedForTeam.All` is the least privileged application permission required to install or upgrade a Teams app that requires consent to [resource-specific consent (RSC)](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) permissions when using the [teamsAppInstallation in a team: upgrade](/graph/api/team-teamsappinstallation-upgrade) API.
181181

182+
### Teamwork and communications | Messaging
183+
184+
Use the [replyWithQuote](/graph/api/chatmessage-replywithquote) method on the [chatMessage](/graph/api/resources/chatmessage) resource to reply with a quote to a single chat message or multiple chat messages in a chat.
185+
182186
## January 2026: New in preview only
183187

184188
### Applications

0 commit comments

Comments
 (0)