conversationThread resource type

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

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

Properties

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.

Relationships

Relationship Type Description
posts post collection Read-only. Nullable.

JSON representation

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"]
}