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