conversationThread resource type
Namespace: microsoft.graph
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.
Methods
| Method | Return Type | Description |
|---|---|---|
| List | conversationThread collection | Get all the threads of a group. |
| Create | conversationThread | Start a new conversation by first creating a thread. A new conversation, conversation thread, and post are created in the group. |
| Get | conversationThread | Get a specific thread that belongs to a group. |
| Update | conversationThread | Update conversationThread object. |
| Delete | None | Delete conversationThread object. |
| Reply to conversation thread | None | Reply to this thread by creating a new Post entity. |
| List posts | post collection | Get the posts of the specified thread. |
Properties
| Property | Type | Description |
|---|---|---|
| ccRecipients | recipient collection | The Cc: recipients for the thread. Returned only on $select. |
| hasAttachments | Boolean | Indicates whether any of the posts within this thread has at least one attachment. Returned by default. |
| id | String | Read-only. Returned by default. |
| isLocked | Boolean | Indicates if the thread is locked. Returned by default. |
| 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 is 2014-01-01T00:00:00Z.Returned by default. |
| preview | String | A short summary from the body of the latest post in this conversation. Returned by default. |
| topic | String | The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated. Returned by default. |
| toRecipients | recipient collection | The To: recipients for the thread. Returned only on $select. |
| uniqueSenders | String collection | All the users that sent a message to this thread. Returned by default. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| posts | post collection | Read-only. Nullable. |
JSON representation
The following JSON representation shows the resource type.
{
"ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"hasAttachments": true,
"id": "string (identifier)",
"isLocked": true,
"lastDeliveredDateTime": "String (timestamp)",
"preview": "string",
"topic": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"uniqueSenders": ["string"]
}