Microsoft
Microsoft Graph
Microsoft
A conversationThread is a collection of posts.
The last post's recipients collection is the aggregated recipients of the entire thread. A thread can have a growing collection of recipients. A new thread is created when a recipient is removed from the thread.
| Method | Return Type | Description |
|---|---|---|
| List threads | conversationThread collection | Get all the threads of a group. |
| Create thread | conversationThread | Start a new conversation by first creating a thread. A new conversation, conversation thread, and post are created in the group. |
| Get conversationThread | conversationThread | Get a specific thread that belongs to a group. |
| Update | conversationThread | Update conversationThread object. |
| Delete | None | Delete conversationThread object. |
| Reply | None | Reply to this thread by creating a new Post entity. |
| List Posts | post collection | Get the posts of the specified thread. |
| Property | Type | Description | |
|---|---|---|---|
| id | String | Read-only. | |
| toRecipients | recipient collection | The To: recipients for the thread. | |
| ccRecipients | recipient collection | The Cc: recipients for the thread. | |
| topic | String | The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated. | |
| hasAttachments | Boolean | Indicates whether any of the posts within this thread has at least one attachment. | |
| lastDeliveredDateTime | DateTimeOffset | The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' |
|
| uniqueSenders | String collection | All the users that sent a message to this thread. | |
| preview | String | A short summary from the body of the latest post in this converstaion. | |
| isLocked | Boolean | Indicates if the thread is locked. |
| Relationship | Type | Description |
|---|---|---|
| posts | post collection | Read-only. Nullable. |
Here is a JSON representation of the resource
{
"ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"hasAttachments": true,
"id": "string (identifier)",
"isLocked": true,
"lastDeliveredDateTime": "String (timestamp)",
"preview": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"topic": "string",
"uniqueSenders": ["string"]
}