| title | plannerTaskChatMessage resource type |
|---|---|
| description | Represents a chat message associated with a planner task. |
| author | pavlodatsiuk |
| ms.localizationpriority | medium |
| ms.subservice | planner |
| doc_type | resourcePageType |
| ms.date | 01/23/2026 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents a chat message associated with a plannerTask. Task chat messages allow users to communicate and collaborate directly within the context of a task.
| Method | Return Type | Description |
|---|---|---|
| List messages | plannerTaskChatMessage collection | Get the chat messages associated with a Planner task. |
| Create message | plannerTaskChatMessage | Create a new chat message on a Planner task. |
| Update message | plannerTaskChatMessage | Update the properties of a chat message. |
| Delete message | None | Delete a chat message from a Planner task. |
| Set reaction | None | Set a reaction to a chat message. |
| Unset reaction | None | Remove a reaction from a chat message. |
| Property | Type | Description |
|---|---|---|
| content | String | The content of the chat message. Supports plain text and sanitized HTML. |
| createdBy | identitySet | The identity of the user who created the message. |
| createdDateTime | DateTimeOffset | The date and time when the message was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| deletedTime | DateTimeOffset | The date and time when the message was deleted. null if the message hasn't been deleted. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. |
| editedTime | DateTimeOffset | The date and time when the message was last edited. null if the message hasn't been edited. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. |
| id | String | Read-only. The unique identifier of the message. |
| mentions | plannerTaskChatMention collection | The list of mentions in the message. |
| messageType | plannerTaskChatMessageType | The type of message. The possible values are: richTextHtml, unknownFutureValue. |
| parentEntityId | String | The ID of the parent plannerTask that this message belongs to. |
| reactions | plannerTaskChatReaction collection | The reactions on the message. |
None.
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.plannerTaskChatMessage",
"content": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"deletedTime": "String (timestamp)",
"editedTime": "String (timestamp)",
"id": "String (identifier)",
"mentions": [{"@odata.type": "microsoft.graph.plannerTaskChatMention"}],
"messageType": "String",
"parentEntityId": "String",
"reactions": [{"@odata.type": "microsoft.graph.plannerTaskChatReaction"}]
}