conversation resource type

Namespace: microsoft.graph

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 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
preview String A short summary from the body of the latest post in this conversation. Supports $filter (eq, ne, le, ge).
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",
  "threads": [{"@odata.type": "microsoft.graph.conversationThread"}],
  "topic": "string",
  "uniqueSenders": ["string"]
}