TeamworkTargetedMessage.ReadWrite
Allows the user to update group chat or channel targeted messages in Microsoft Teams.
Merill's Note
For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the
TeamworkTargetedMessage.ReadWritepermission.If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the
Export-MsIdAppConsentGrantReportcommand. See How To: Run a quick OAuth app audit of your tenant
| Category | Application | Delegated |
|---|---|---|
| Identifier | - | 162354de-2885-4e5a-94fb-2f03019a65a8 |
| DisplayText | - | Update targeted messages belonging to the user |
| Description | - | Allows the user to update group chat or channel targeted messages in Microsoft Teams. |
| AdminConsentRequired | Yes | Yes |
Graph Methods
→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)
| Methods |
|---|
Resources
Granting this permission allows the calling application to access (and/or update) the following information in your tenant.
Graph reference: targetedChatMessage
| Property | Type | Description |
|---|---|---|
| attachments | chatMessageAttachment collection | References to attached objects like files, tabs, meetings, or other items. Inherited from chatMessage. |
| body | itemBody | The content of the message. Inherited from chatMessage. |
| channelIdentity | channelIdentity | The channel and team information if the targeted message was sent in a channel context. Contains the channelId and teamId properties. Inherited from chatMessage. |
| chatId | String | The unique identifier of the chat if the targeted message was sent in a group chat context. Inherited from chatMessage. |
| 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. Inherited from chatMessage. |
| deletedDateTime | DateTimeOffset | The date and time when the message was deleted. 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. Only applicable for retained messages. Inherited from chatMessage. |
| etag | String | Version number of the message. Inherited from chatMessage. |
| eventDetail | eventMessageDetail | Details about the event if this message represents a system event. Inherited from chatMessage. |
| from | chatMessageFromIdentitySet | Details about the sender of the targeted message. Inherited from chatMessage. |
| id | String | Unique identifier of the message. The message ID is only unique within the context of a single conversation (chat or channel) for a specific user. Inherited from chatMessage. |
| importance | chatMessageImportance | The importance of the message. The possible values are: normal, high, urgent. Inherited from chatMessage. |
| lastEditedDateTime | DateTimeOffset | Date and time when the message was last edited. 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. Inherited from chatMessage. |
| lastModifiedDateTime | DateTimeOffset | Date and time when the message or any of its properties was last modified. 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. Inherited from chatMessage. |
| locale | String | The locale of the message as set by the client, formatted as en-us. Inherited from chatMessage. |
| mentions | chatMessageMention collection | List of entities mentioned in the message. Inherited from chatMessage. |
| messageHistory | chatMessageHistoryItem collection | History of edits applied to the message. Inherited from chatMessage. |
| messageType | chatMessageType | The type of message. The possible values are: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: systemEventMessage. Inherited from chatMessage. |
| onBehalfOf | chatMessageFromIdentitySet | Information about the user on whose behalf the message was sent. Inherited from chatMessage. |
| policyViolation | chatMessagePolicyViolation | Information about policy violations applied to the message by data loss prevention (DLP) applications. Inherited from chatMessage. |
| reactions | chatMessageReaction collection | The reactions applied to the message (for example, like, heart, laugh). Inherited from chatMessage. |
| recipient | identity | The intended recipient of the targeted message. |
| replyToId | String | The ID of the parent message or root message of the thread. Inherited from chatMessage. |
| subject | String | The subject of the message. Inherited from chatMessage. |
| summary | String | Summary text of the message that can be used for notifications or summary views. Inherited from chatMessage. |
| webUrl | String | The link to the message in Microsoft Teams. Inherited from chatMessage. |