post resource type
Namespace: microsoft.graph Represents an individual Post item within a conversationThread entity.
Even though you cannot explicitly create a post, doing any of the following would create a post:
- Reply to an existing post
- Reply to an existing thread
- Create a thread in a new conversation
- Create a new conversation
This resource lets you add your own data to custom properties using extensions.
Methods
| Method | Return Type | Description |
|---|---|---|
| List posts | post | Get the posts of the specified thread. |
| Get post | post | Get the properties and relationships of a post in a specified thread. |
| Reply post | None | Reply to a post and add a new post to the specified thread in a group conversation. |
| Forward post | None | Forward a post to a recipient. |
| Attachments | ||
| List attachments | attachment collection | Get all attachments on a post. |
| Add attachment | attachment | Add an attachment to a post. |
| Open extensions | ||
| Create open extension | openTypeExtension | Create an open extension and add custom properties in a new or existing instance of a resource. |
| Get open extension | openTypeExtension collection | Get an open extension object or objects identified by name or fully qualified name. |
| Extended properties | ||
| Create single-value property | post | Create one or more single-value extended properties in a new or existing post. |
| Get single-value property | post | Get posts that contain a single-value extended property by using $expand or $filter. |
| Create multi-value property | post | Create one or more multi-value extended properties in a new or existing post. |
| Get multi-value property | post | Get a post that contains a multi-value extended property by using $expand. |
Properties
| Property | Type | Description |
|---|---|---|
| body | itemBody | The contents of the post. This is a default property. This property can be null. |
| categories | String collection | The categories associated with the post. |
| changeKey | String | Identifies the version of the post. Every time the post is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object. |
| conversationId | String | Unique ID of the conversation. Read-only. |
| conversationThreadId | String | Unique ID of the conversation thread. Read-only. |
| createdDateTime | DateTimeOffset | Specifies when the post was created. The DateTimeOffset 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 |
| from | recipient | Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property. |
| hasAttachments | Boolean | Indicates whether the post has at least one attachment. This is a default property. |
| id | String | Read-only. |
| lastModifiedDateTime | DateTimeOffset | Specifies when the post was last modified. The DateTimeOffset 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 |
| newParticipants | recipient collection | Conversation participants that were added to the thread as part of this post. |
| receivedDateTime | DateTimeOffset | Specifies when the post was received. The DateTimeOffset 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 |
| sender | recipient | Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| attachments | Attachment collection | Read-only. Nullable. Supports $expand. |
| extensions | Extension collection | The collection of open extensions defined for the post. Read-only. Nullable. Supports $expand. |
| inReplyTo | post | Read-only. Supports $expand. |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty collection | The collection of multi-value extended properties defined for the post. Read-only. Nullable. |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | The collection of single-value extended properties defined for the post. Read-only. Nullable. |
JSON representation
The following JSON representation shows the resource type.
{
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["string"],
"changeKey": "string",
"conversationId": "string",
"conversationThreadId": "string",
"createdDateTime": "String (timestamp)",
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}