conversation resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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.

This resource supports subscribing to change notifications.

Methods

Method Return Type Description
List conversations conversation collection Get the list of conversations in this group.
Create conversation 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. Supports $filter (eq, ne) and $search.
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 is 2014-01-01T00:00:00Z. Supports $filter (eq, ne, le, ge).
preview String A short summary from the body of the latest post in this conversation.
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

The following JSON representation shows the resource type.

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