Skip to content

Commit 07fb58f

Browse files
committed
Updated Conversation and ConversationThread related API mds
1 parent 95f7a4a commit 07fb58f

16 files changed

+61
-121
lines changed

api-reference/v1.0/api/conversation_delete.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22

33
Delete conversation.
44
### Prerequisites
5-
One of the following **scopes** is required to execute this API:
5+
One of the following **scopes** is required to execute this API:
66
*Group.ReadWrite.All*
7+
78
### HTTP request
89
<!-- { "blockType": "ignored" } -->
910
```http
1011
DELETE /groups/<id>/conversations/<id>
11-
DELETE /groups/<id>/conversations/<id>
1212
```
1313
### Request headers
14-
| Name | Type | Description|
15-
|:---------------|:--------|:----------|
16-
| Authorization | string | Bearer <token>. Required. |
14+
| Header | Value |
15+
|:---------------|:--------|
16+
| Authorization | Bearer <token>. Required. |
1717

1818
### Request body
1919
Do not supply a request body for this method.

api-reference/v1.0/api/conversation_get.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ One of the following **scopes** is required to execute this API:
88
<!-- { "blockType": "ignored" } -->
99
```http
1010
GET /groups/<id>/conversations/<id>
11-
GET /groups/<id>/conversations/<id>
11+
1212
```
1313
### Optional query parameters
1414
This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response.
1515
### Request headers
16-
| Name | Type | Description|
17-
|:-----------|:------|:----------|
18-
| Authorization | string | Bearer <token>. Required. |
16+
| Header | Value |
17+
|:---------------|:--------|
18+
| Authorization | Bearer <token>. Required. |
1919

2020
### Request body
2121
Do not supply a request body for this method.

api-reference/v1.0/api/conversation_list_threads.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,18 @@ One of the following **scopes** is required to execute this API:
88
<!-- { "blockType": "ignored" } -->
99
```http
1010
GET /groups/<id>/conversations/<id>/threads
11-
GET /groups/<id>/conversations/<id>/threads
1211
```
1312
### Optional query parameters
1413
This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response.
1514
### Request headers
16-
| Name | Type | Description|
17-
|:-----------|:------|:----------|
18-
| Authorization | string | Bearer <token>. Required. |
15+
| Header | Value |
16+
|:---------------|:--------|
17+
| Authorization | Bearer <token>. Required. |
1918

2019
### Request body
2120
Do not supply a request body for this method.
2221
### Response
23-
If successful, this method returns a `200 OK` response code and collection of [ConversationThread](../resources/conversationthread.md) objects in the response body.
22+
If successful, this method returns a `200 OK` response code and collection of [conversationThread](../resources/conversationthread.md) objects in the response body.
2423
### Example
2524
##### Request
2625
Here is an example of the request.

api-reference/v1.0/api/conversation_post_threads.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,19 @@ One of the following **scopes** is required to execute this API:
88
<!-- { "blockType": "ignored" } -->
99
```http
1010
POST /groups/<id>/conversations/<id>/threads
11-
POST /groups/<id>/conversations/<id>/threads
11+
1212
```
1313
### Request headers
14-
| Name | Type | Description|
15-
|:---------------|:--------|:----------|
16-
| Authorization | string | Bearer <token>. Required. |
14+
| Header | Value |
15+
|:---------------|:--------|
16+
| Authorization | Bearer <token>. Required. |
1717

1818
### Request body
19-
In the request body, supply a JSON representation of [ConversationThread](../resources/conversationthread.md) object.
19+
In the request body, supply a JSON representation of [conversationThread](../resources/conversationthread.md) object.
2020

2121

2222
### Response
23-
If successful, this method returns `201, Created` response code and [ConversationThread](../resources/conversationthread.md) object in the response body.
23+
If successful, this method returns `201, Created` response code and [conversationThread](../resources/conversationthread.md) object in the response body.
2424

2525
### Example
2626
##### Request

api-reference/v1.0/api/conversation_update.md

Lines changed: 4 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -8,23 +8,19 @@ One of the following **scopes** is required to execute this API:
88
<!-- { "blockType": "ignored" } -->
99
```http
1010
PATCH /groups/<id>/conversations/<id>
11-
PATCH /groups/<id>/conversations/<id>
11+
1212
```
1313
### Request headers
14-
| Name | Type | Description|
15-
|:-----------|:------|:----------|
16-
| Authorization | string | Bearer <token>. Required. |
14+
| Header | Value |
15+
|:---------------|:--------|
16+
| Authorization | Bearer <token>. Required. |
1717

1818
### Request body
1919
In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.
2020

2121
| Property | Type |Description|
2222
|:---------------|:--------|:----------|
23-
|hasAttachments|Boolean|Indicates whether the Conversation has at least one attachment.|
24-
|lastDeliveredDateTime|DateTimeOffset||
25-
|preview|String||
2623
|topic|String|The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.|
27-
|uniqueSenders|String|All the users that sent a message to this Conversation.|
2824

2925
### Response
3026
If successful, this method returns a `200 OK` response code and updated [conversation](../resources/conversation.md) object in the response body.
@@ -42,12 +38,6 @@ Content-length: 181
4238
4339
{
4440
"topic": "topic-value",
45-
"hasAttachments": true,
46-
"lastDeliveredDateTime": "datetime-value",
47-
"uniqueSenders": [
48-
"uniqueSenders-value"
49-
],
50-
"preview": "preview-value"
5141
}
5242
```
5343
##### Response

api-reference/v1.0/api/conversationthread_delete.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
Delete conversationThread.
44
### Prerequisites
5-
One of the following **scopes** is required to execute this API:
5+
One of the following **scopes** is required to execute this API:
6+
*Group.ReadWrite.All*
7+
68
### HTTP request
79
<!-- { "blockType": "ignored" } -->
810
```http
@@ -11,9 +13,9 @@ DELETE /groups/<id>/conversations/<id>/threads/<id>
1113
1214
```
1315
### Request headers
14-
| Name | Type | Description|
15-
|:---------------|:--------|:----------|
16-
| Authorization | string | Bearer <token>. Required. |
16+
| Header | Value |
17+
|:---------------|:--------|
18+
| Authorization | Bearer <token>. Required. |
1719

1820
### Request body
1921
Do not supply a request body for this method.

api-reference/v1.0/api/conversationthread_get.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
Retrieve the properties and relationships of conversationthread object.
44
### Prerequisites
5-
One of the following **scopes** is required to execute this API:
5+
One of the following **scopes** is required to execute this API:
6+
*Group.ReadWrite.All; Group.Read.All*
7+
68
### HTTP request
79
<!-- { "blockType": "ignored" } -->
810
```http
@@ -13,9 +15,9 @@ GET /groups/<id>/conversations/<id>/threads/<id>
1315
### Optional query parameters
1416
This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response.
1517
### Request headers
16-
| Name | Type | Description|
17-
|:-----------|:------|:----------|
18-
| Authorization | string | Bearer <token>. Required. |
18+
| Header | Value |
19+
|:---------------|:--------|
20+
| Authorization | Bearer <token>. Required. |
1921

2022
### Request body
2123
Do not supply a request body for this method.

api-reference/v1.0/api/conversationthread_list_posts.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@
33
Retrieve a list of post objects.
44
### Prerequisites
55
One of the following **scopes** is required to execute this API:
6+
*Group.ReadWrite.All; Group.Read.All*
7+
68
### HTTP request
79
<!-- { "blockType": "ignored" } -->
810
```http
@@ -13,9 +15,9 @@ GET /groups/<id>/conversations/<id>/threads/<id>/posts
1315
### Optional query parameters
1416
This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response.
1517
### Request headers
16-
| Name | Type | Description|
17-
|:-----------|:------|:----------|
18-
| Authorization | string | Bearer <token>. Required. |
18+
| Header | Value |
19+
|:---------------|:--------|
20+
| Authorization | Bearer <token>. Required. |
1921

2022
### Request body
2123
Do not supply a request body for this method.

api-reference/v1.0/api/conversationthread_post_posts.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
Use this API to create a new Post.
44
### Prerequisites
5-
One of the following **scopes** is required to execute this API:
5+
One of the following **scopes** is required to execute this API:
6+
*Group.ReadWrite.All*
7+
68
### HTTP request
79
<!-- { "blockType": "ignored" } -->
810
```http
@@ -11,16 +13,16 @@ POST /groups/<id>/conversations/<id>/threads/<id>/posts
1113
1214
```
1315
### Request headers
14-
| Name | Type | Description|
15-
|:---------------|:--------|:----------|
16-
| Authorization | string | Bearer <token>. Required. |
16+
| Header | Value |
17+
|:---------------|:--------|
18+
| Authorization | Bearer <token>. Required. |
1719

1820
### Request body
19-
In the request body, supply a JSON representation of [Post](../resources/post.md) object.
21+
In the request body, supply a JSON representation of [post](../resources/post.md) object.
2022

2123

2224
### Response
23-
If successful, this method returns `201, Created` response code and [Post](../resources/post.md) object in the response body.
25+
If successful, this method returns `201, Created` response code and [post](../resources/post.md) object in the response body.
2426

2527
### Example
2628
##### Request
@@ -40,8 +42,6 @@ Content-length: 414
4042
},
4143
"content": "content-value"
4244
},
43-
"receivedDateTime": "datetime-value",
44-
"hasAttachments": true,
4545
"from": {
4646
"emailAddress": {
4747
"name": "name-value",
@@ -54,7 +54,6 @@ Content-length: 414
5454
"address": "address-value"
5555
}
5656
},
57-
"conversationThreadId": "conversationThreadId-value"
5857
}
5958
```
6059
In the request body, supply a JSON representation of [post](../resources/post.md) object.

api-reference/v1.0/api/conversationthread_reply.md

Lines changed: 7 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33

44
### Prerequisites
5-
One of the following **scopes** is required to execute this API:
5+
One of the following **scopes** is required to execute this API:
6+
*Group.ReadWrite.All*
7+
68
### HTTP request
79
<!-- { "blockType": "ignored" } -->
810
```http
@@ -11,16 +13,16 @@ POST /groups/<id>/conversations/<id>/threads/<id>/microsoft.graph.reply
1113
1214
```
1315
### Request headers
14-
| Name | Type | Description|
15-
|:---------------|:--------|:----------|
16-
| Authorization | string | Bearer <token>. Required. |
16+
| Header | Value |
17+
|:---------------|:--------|
18+
| Authorization | Bearer <token>. Required. |
1719

1820
### Request body
1921
In the request body, provide a JSON object with the following parameters.
2022

2123
| Parameter | Type |Description|
2224
|:---------------|:--------|:----------|
23-
|post|Post||
25+
|post|[post](../resources/post.md)||
2426

2527
### Response
2628
If successful, this method returns `200, OK` response code. It does not return anything in the response body.
@@ -45,21 +47,6 @@ Content-length: 1131
4547
},
4648
"content": "content-value"
4749
},
48-
"receivedDateTime": "datetime-value",
49-
"hasAttachments": true,
50-
"from": {
51-
"emailAddress": {
52-
"name": "name-value",
53-
"address": "address-value"
54-
}
55-
},
56-
"sender": {
57-
"emailAddress": {
58-
"name": "name-value",
59-
"address": "address-value"
60-
}
61-
},
62-
"conversationThreadId": "conversationThreadId-value",
6350
"newParticipants": [
6451
{
6552
"emailAddress": {
@@ -68,16 +55,9 @@ Content-length: 1131
6855
}
6956
}
7057
],
71-
"conversationId": "conversationId-value",
72-
"createdDateTime": "datetime-value",
73-
"lastModifiedDateTime": "datetime-value",
74-
"changeKey": "changeKey-value",
7558
"categories": [
7659
"categories-value"
7760
],
78-
"id": "id-value",
79-
"inReplyTo": {
80-
},
8161
"attachments": [
8262
{
8363
"lastModifiedDateTime": "datetime-value",
@@ -92,7 +72,6 @@ Content-length: 1131
9272
}
9373
```
9474

95-
##### Response
9675
##### Response
9776
Here is an example of the response.
9877
<!-- {

0 commit comments

Comments
 (0)