post 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.
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 to a new or existing resource. |
| Get open extension | openTypeExtension collection | Get an open extension identified by the extension 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. Each category corresponds to the displayName property of an outlookCategory that has been defined for a user. |
| 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. |
| importance | importance | The importance of a group post: low, normal, high. |
| 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 | The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the post. Read-only. Nullable. Supports $expand. |
| extensions | Extension collection | The collection of open extensions defined for the post. Read-only. Nullable. Supports $expand. |
| inReplyTo | Post | The earlier post that this post is replying to in the conversationThread. 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)",
"importance": "string",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}