conversation 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 conversation is a collection of threads, and a thread contains posts to that thread. All threads and posts in a conversation share the same subject.

Methods

Method Return Type Description
List conversations conversation collection Get the list of conversations in this group.
Create conversation Create a new conversation by including a thread and a post.
Get conversation conversation Read properties and relationships of conversation object.
Delete None Delete conversation object.
List conversation threads conversationThread collection Get all the threads in a group conversation.
Create conversation thread conversationThread collection Create a thread in the specified conversation.

Properties

Property Type Description
hasAttachments Boolean Indicates whether any of the posts within this Conversation has at least one attachment.
id String The conversations's unique identifier. Read-only.
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'
preview String A short summary from the body of the latest post in this converstaion.
topic String The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.
uniqueSenders String collection All the users that sent a message to this Conversation.

Relationships

Relationship Type Description
threads conversationThread collection A collection of all the conversation threads in the conversation. A navigation property. Read-only. Nullable.

JSON representation

Here is a JSON representation of the resource

{
  "hasAttachments": true,
  "id": "string (identifier)",
  "lastDeliveredDateTime": "String (timestamp)",
  "preview": "string",
  "topic": "string",
  "uniqueSenders": ["string"]
}