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.


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


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",
  "topic": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueSenders": ["string"]