Updates from: 07/01/2021 03:07:50
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list.md
Content-type: application/json
"createdDateTime": "2020-12-08T23:53:05.801Z", "lastUpdatedDateTime": "2020-12-08T23:58:32.511Z", "chatType": "meeting",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-06-03T08:05:49.521Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3Ameeting_MjdhNjM4YzUtYzExZi00OTFkLTkzZTAtNTVlNmZmMDhkNGU2@thread.v2/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f" }, {
Content-type: application/json
"createdDateTime": "2020-12-03T19:41:07.054Z", "lastUpdatedDateTime": "2020-12-08T23:53:11.012Z", "chatType": "group",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-05-27T22:13:01.577Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3A561082c0f3f847a58069deb8eb300807@thread.v2/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f" }, {
Content-type: application/json
"createdDateTime": "2020-12-04T23:10:28.51Z", "lastUpdatedDateTime": "2020-12-04T23:10:36.925Z", "chatType": "oneOnOne",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "0001-01-01T00:00:00Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3Ad74fc2ed-cb0e-4288-a219-b5c71abaf2aa_8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca@unq.gbl.spaces/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f" } ]
Content-type: application/json
"createdDateTime": "2020-12-08T23:53:05.801Z", "lastUpdatedDateTime": "2020-12-08T23:58:32.511Z", "chatType": "meeting",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-04-02T08:15:02.091Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3Ameeting_MjdhNjM4YzUtYzExZi00OTFkLTkzZTAtNTVlNmZmMDhkNGU2@thread.v2/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f", "members@odata.context": "https://graph.microsoft.com/bethkNGU2%40thread.v2')/members", "members": [
Content-type: application/json
"createdDateTime": "2020-12-03T19:41:07.054Z", "lastUpdatedDateTime": "2020-12-08T23:53:11.012Z", "chatType": "group",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "0001-01-01T00:00:00Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3A561082c0f3f847a58069deb8eb300807@thread.v2/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f", "members@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3A561082c0f3f847a58069deb8eb300807%40thread.v2')/members", "members": [
Content-type: application/json
"createdDateTime": "2020-12-04T23:10:28.51Z", "lastUpdatedDateTime": "2020-12-04T23:10:36.925Z", "chatType": "oneOnOne",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-06-05T00:31:30.047Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3Ad74fc2ed-cb0e-4288-a219-b5c71abaf2aa_8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca@unq.gbl.spaces/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f", "members@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3Ad74fc2ed-cb0e-4288-a219-b5c71abaf2aa_8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca%40unq.gbl.spaces')/members", "members": [
Content-type: application/json
} ```
-### Example 3: List all the chats that have a member with a specific display name
+### Example 3: List chats along with the preview of the last message sent in the chat
+
+#### Request
+
+The following example shows a request to list chats along with the preview of the last message sent in the chat. Comparing `createdDateTime` on the preview to `lastMessageReadDateTime` in `viewpoint` allows the caller to determine whether the user has read all messages in a chat.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_chats_expand_lastMessagePreview"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/chats?$expand=lastMessagePreview
+```
+
+#### Response
+
+Here is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.chat",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats(lastMessagePreview())",
+ "@odata.count": 3,
+ "@odata.nextLink": "https://graph.microsoft.com/bet8c2ZiaW50ZXJvcGNoYXR8cGhvbmVjaGF0In0%3d",
+ "value": [
+ {
+ "id": "19:8ea0e38b-efb3-4757-924a-5f94061cf8c2_976f4b31-fd01-4e0b-9178-29cc40c14438@unq.gbl.spaces",
+ "topic": null,
+ "createdDateTime": "2021-06-05T00:31:30.767Z",
+ "lastUpdatedDateTime": "2021-06-05T00:31:32.806Z",
+ "chatType": "oneOnOne",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-06-05T00:31:30.047Z"
+ },
+ "lastMessagePreview@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3A8ea0e38b-efb3-4757-924a-5f94061cf8c2_976f4b31-fd01-4e0b-9178-29cc40c14438%40unq.gbl.spaces')/lastMessagePreview/$entity",
+ "lastMessagePreview": {
+ "id": "1622853091207",
+ "createdDateTime": "2021-06-05T00:31:31.207Z",
+ "isDeleted": false,
+ "body": {
+ "contentType": "text",
+ "content": "Testing unread read status"
+ },
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
+ "displayName": "Nick Fury",
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "id": "19:8ea0e38b-efb3-4757-924a-5f94061cf8c2_da7d471b-de7d-4152-8556-1cdf7a564f6c@unq.gbl.spaces",
+ "topic": null,
+ "createdDateTime": "2020-07-17T22:46:28.077Z",
+ "lastUpdatedDateTime": "2021-06-03T08:05:49.788Z",
+ "chatType": "oneOnOne",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-06-03T08:05:49.521Z"
+ },
+ "lastMessagePreview@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3A8ea0e38b-efb3-4757-924a-5f94061cf8c2_da7d471b-de7d-4152-8556-1cdf7a564f6c%40unq.gbl.spaces')/lastMessagePreview/$entity",
+ "lastMessagePreview": {
+ "id": "1622707540293",
+ "createdDateTime": "2021-06-03T08:05:40.293Z",
+ "isDeleted": false,
+ "body": {
+ "contentType": "html",
+ "content": "<attachment id=\"ee8d34acd36d4dfe87ca6ad4e060b7be\"></attachment>"
+ },
+ "from": {
+ "device": null,
+ "user": null,
+ "application": {
+ "id": "da7d471b-de7d-4152-8556-1cdf7a564f6c",
+ "displayName": "talla",
+ "applicationIdentityType": "bot"
+ }
+ }
+ }
+ },
+ {
+ "id": "19:a6bac1f4daaf4db3bc6ac7536721331f@thread.v2",
+ "topic": null,
+ "createdDateTime": "2021-05-19T16:46:20.564Z",
+ "lastUpdatedDateTime": "2021-05-27T22:13:03.169Z",
+ "chatType": "group",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-05-27T22:13:01.577Z"
+ },
+ "lastMessagePreview@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3Aa6bac1f4daaf4db3bc6ac7536721331f%40thread.v2')/lastMessagePreview/$entity",
+ "lastMessagePreview": {
+ "id": "1621533401696",
+ "createdDateTime": "2021-05-20T17:56:41.696Z",
+ "isDeleted": false,
+ "body": {
+ "contentType": "text",
+ "content": "sup"
+ },
+ "from": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4595d2f2-7b31-446c-84fd-9b795e63114b",
+ "displayName": "Peter Parker",
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ }
+ ]
+}
+```
+
+### Example 4: List all the chats that have a member with a specific display name
#### Request
Content-type: application/json
"createdDateTime": "2020-12-08T23:53:05.801Z", "lastUpdatedDateTime": "2020-12-08T23:58:32.511Z", "chatType": "meeting",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-06-05T00:01:30.233Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3Ameeting_MjdhNjM4YzUtYzExZi00OTFkLTkzZTAtNTVlNmZmMDhkNGU2@thread.v2/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f", "members@odata.context": "https://graph.microsoft.com/bethkNGU2%40thread.v2')/members", "members": [
Content-type: application/json
"createdDateTime": "2020-12-04T23:10:28.51Z", "lastUpdatedDateTime": "2020-12-04T23:10:36.925Z", "chatType": "oneOnOne",
+ "chatViewpoint": {
+ "lastMessageReadDateTime": "2021-06-05T00:31:30.047Z"
+ },
"webUrl": "https://teams.microsoft.com/l/chat/19%3Ad74fc2ed-cb0e-4288-a219-b5c71abaf2aa_8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca@unq.gbl.spaces/0?tenantId=b33cbe9f-8ebe-4f2a-912b-7e2a427f477f", "members@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3Ad74fc2ed-cb0e-4288-a219-b5c71abaf2aa_8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca%40unq.gbl.spaces')/members", "members": [
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/channel.md
where files are shared, and where tabs are added.
|isFavoriteByDefault|Boolean|Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with [Create team](../api/team-post.md). Default: `false`.| |email|String| The email address for sending messages to the channel. Read-only.| |webUrl|String|A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.|
-|membershipType|[channelMembershipType](../resources/enums.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and cannot be changed. Default: standard.|
+|membershipType|[channelMembershipType](../resources/enums.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. Default: standard.|
|createdDateTime|dateTimeOffset|Read only. Timestamp at which the channel was created.| |moderationSettings|[channelModerationSettings](../resources/channelmoderationsettings.md)|Settings to configure channel moderation to control who can start new posts and reply to posts in that channel.|
v1.0 Chat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chat.md
not all scenarios are possible. It is possible to get chat IDs with delegated pe
| createdDateTime| dateTimeOffset| Date and time at which the chat was created. Read-only.| | lastUpdatedDateTime| dateTimeOffset| Date and time at which the chat was renamed or list of members were last changed. Read-only.| | chatType| [chatType](../resources/chat.md#chattype-values) | Specifies the type of chat. Possible values are:`group`, `oneOnOne` and `meeting`.|
-| webUrl | string | A hyperlink that will go to the chat in Microsoft Teams. This URL should be treated as an opaque blob, and not parsed. Read-only. |
+| viewpoint|[chatViewpoint](../resources/chatviewpoint.md)|Represents caller-specific information about the chat, such as last message read date and time. This property is populated only when the request is made in a delegated context.|
+| webUrl| String | A hyperlink that will go to the chat in Microsoft Teams. This URL should be treated as an opaque blob, and not parsed. Read-only.|
### chatType values
not all scenarios are possible. It is possible to get chat IDs with delegated pe
| members | [conversationMember](conversationmember.md) collection | A collection of all the members in the chat. Nullable. | | messages | [chatMessage](chatmessage.md) collection | A collection of all the messages in the chat. Nullable. | | permissionGrants| [resourceSpecificPermissionGrant](resourcespecificpermissiongrant.md) collection| A collection of permissions granted to apps for the chat.|
-| operations | [teamsAsyncOperation](teamsasyncoperation.md) collection | A collection of all the Teams async operations that ran or are running on the chat. Nullable. |
+| operations | [teamsAsyncOperation](teamsasyncoperation.md) collection | A collection of all the Teams async operations that ran or are running on the chat. Nullable.
+| lastMessagePreview | [chatMessageInfo](chatmessageinfo.md)| Preview of the last message sent in the chat. Null if no messages have been sent in the chat. Currently, only the [list chats](../api/chat-list.md) operation supports this property.|
## JSON representation
Here is a JSON representation of the resource.
"createdDateTime": "dateTimeOffset", "lastUpdatedDateTime": "dateTimeOffset", "chatType": "String",
+ "chatViewpoint": {
+ "@odata.type": "microsoft.graph.chatViewpoint"
+ },
"webUrl": "string" } ```
v1.0 Chatmessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessage.md
Represents an individual chat message within a [channel](channel.md) or [chat](c
|:|:--|:-| |id|String| Read-only. Unique ID of the message.| |replyToId| string | Read-only. ID of the parent chat message or root chat message of the thread. (Only applies to chat messages in channels, not chats.) |
-|from|[identitySet](identityset.md)| Read only. Details of the sender of the chat message.|
+|from|[chatMessageFromIdentitySet](chatmessagefromidentityset.md)| Read only. Details of the sender of the chat message.|
|etag| string | Read-only. Version number of the chat message. | |messageType|string|The type of chat message. The possible value is: `message`.| |createdDateTime|dateTimeOffset|Timestamp of when the chat message was created.|
The following is a JSON representation of the resource.
{ "id": "string (identifier)", "replyToId": "string (identifier)",
- "from": {"@odata.type": "microsoft.graph.identitySet"},
+ "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"etag": "string", "messageType": "string", "createdDateTime": "string (timestamp)",
v1.0 Chatmessagefromidentityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessagefromidentityset.md
+
+ Title: "chatMessageFromIdentitySet resource type"
+description: "Represents the sender of a message in a chat or a channel."
+
+localization_priority: Normal
++
+# chatMessageFromIdentitySet resource type
+
+Namespace: microsoft.graph
++
+Represents the sender of a [message](../resources/chatmessage.md) in a chat or a channel. This object may be `null` for a message that has been deleted or sent by the Microsoft Teams internal system; for example, event messages for addition of members.
++
+Inherits from [identitySet](../resources/identityset.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents the application (for example, bot) that sent the message.|
+|device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not used.|
+|user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents the user that sent the message.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMessageFromIdentitySet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageFromIdentitySet",
+ "user": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "application": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "device": {
+ "@odata.type": "microsoft.graph.identity"
+ }
+}
+```
+
v1.0 Chatmessageinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessageinfo.md
+
+ Title: "chatMessageInfo resource type"
+description: "Represents a preview of a chatMessage resource."
+
+localization_priority: Normal
++
+# chatMessageInfo resource type
+
+Namespace: microsoft.graph
++
+Represents a preview of a [chatMessage](../resources/chatmessage.md) resource. This object can only be fetched as part of a list of [chats](../resources/chat.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|body|[itemBody](../resources/itembody.md)|Body of the [chatMessage](../resources/chatmessage.md). This will still contain markers for @mentions and attachments even though the object does not return @mentions and attachments.|
+|createdDateTime|DateTimeOffset|Date time object representing the time at which message was created.|
+|from|[chatMessageFromIdentitySet](../resources/chatmessagefromidentityset.md)|Information about the sender of the message.|
+|id|String|ID of the [chatMessage](../resources/chatmessage.md).|
+|isDeleted|Boolean|If set to `true`, the original message has been deleted.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.chatMessageInfo",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageInfo",
+ "id": "String (identifier)",
+ "body": {
+ "@odata.type": "microsoft.graph.itemBody"
+ },
+ "from": {
+ "@odata.type": "microsoft.graph.chatMessageFromIdentitySet"
+ },
+ "createdDateTime": "String (timestamp)",
+ "isDeleted": "Boolean"
+}
+```
+
+## See also
+
+- [chat](../resources/chat.md)
+- [chatMessage](../resources/chatmessage.md)
+
v1.0 Chatmessagemention https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessagemention.md
For a fuller context of the example, see [List channel message replies](../api/c
|:|:--|:-| |id|Int32|Index of an entity being mentioned in the specified **chatMessage**. Matches the {index} value in the corresponding `<at id="{index}">` tag in the message body.| |mentionText|string|String used to represent the mention. For example, a user's display name, a team name.|
-|mentioned|[identitySet](identityset.md)|The entity (user, application, team, or channel) that was mentioned. If it was a channel or team that was @mentioned, the identitySet contains a **conversation** property giving the ID of the team/channel, and a **conversationIdentityType** property that represents either the team or channel.|
+|mentioned|[chatMessageMentionedIdentitySet](chatmessagementionedidentityset.md)|The entity (user, application, team, or channel) that was @mentioned.|
## JSON representation
The following is a JSON representation of the resource.
{ "id": 1024, "mentionText": "string",
- "mentioned": {"@odata.type": "microsoft.graph.identitySet"}
+ "mentioned": {"@odata.type": "microsoft.graph.chatMessageMentionedIdentitySet"}
} ```
v1.0 Chatmessagementionedidentityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessagementionedidentityset.md
+
+ Title: "chatMessageMentionedIdentitySet resource type"
+description: "Represents the resource @mentioned in a message in a chat or a channel."
+
+localization_priority: Normal
++
+# chatMessageMentionedIdentitySet resource type
+
+Namespace: microsoft.graph
++
+Represents the resource (user, application, or conversation) @mentioned in a [message](../resources/chatmessage.md) in a chat or a channel.
++
+Inherits from [identitySet](../resources/identityset.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents an application (for example, bot) @mentioned in a [message](../resources/chatmessage.md).|
+|conversation|[teamworkConversationIdentity](../resources/teamworkconversationidentity.md)|If present, represents a conversation (for example, team or channel) @mentioned in a [message](../resources/chatmessage.md).|
+|device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not used because it's not supported to @mention devices.|
+|user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents a user @mentioned in a [message](../resources/chatmessage.md).|
+|tag|[teamworkTagIdentity](../resources/teamworktagidentity.md)|If present, represents a tag @mentioned in a team [message](../resources/chatmessage.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMessageMentionedIdentitySet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageMentionedIdentitySet",
+ "user": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "application": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "device": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "conversation": {
+ "@odata.type": "microsoft.graph.teamworkConversationIdentity"
+ },
+ "tag": {
+ "@odata.type": "microsoft.graph.teamworkTagIdentity"
+ }
+}
+```
v1.0 Chatmessagereaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessagereaction.md
An entity of type `chatMessageReaction` is returned as part of the [Get channel
|:-|:|:| |createdDateTime|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`| |reactionType|String|Supported values are `like`, `angry`, `sad`, `laugh`, `heart`, `surprised`. |
-|user|[identitySet](identityset.md)|The user who reacted to the message.|
+|user|[chatMessageReactionIdentitySet](chatmessagereactionidentityset.md)|The user who reacted to the message.|
## JSON representation
The following is a JSON representation of the resource.
{ "createdDateTime": "String (timestamp)", "reactionType": "String",
- "user": {"@odata.type": "microsoft.graph.identitySet"}
+ "user": {"@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"}
} ```
v1.0 Chatmessagereactionidentityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatmessagereactionidentityset.md
+
+ Title: "chatMessageReactionIdentitySet resource type"
+description: "Represents a user that reacted to a message in a chat or a channel."
+
+localization_priority: Normal
++
+# chatMessageReactionIdentitySet resource type
+
+Namespace: microsoft.graph
++
+Represents a **user** that reacted to a [message](../resources/chatmessage.md) in a chat or a channel. Only the `user` property has a value.
++
+Inherits from [identitySet](../resources/identityset.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not set because applications can't react to messages.|
+|device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not set because devices can't react to messages.|
+|user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Details about the user who reacted to the message.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageReactionIdentitySet",
+ "user": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "application": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "device": {
+ "@odata.type": "microsoft.graph.identity"
+ }
+}
+```
+
v1.0 Chatviewpoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/chatviewpoint.md
+
+ Title: "chatViewpoint resource type"
+description: "Represents user-specific properties of a chat."
+
+localization_priority: Normal
++
+# chatViewpoint resource type
+
+Namespace: microsoft.graph
++
+Represents user-specific properties of a [chat](../resources/chat.md). These properties might change based on who the caller of the API is.
+
+> **Note:** Currently, only the [list chats](../api/chat-list.md) operation supports **chatViewpoint**.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|lastMessageReadDateTime|DateTimeOffset|Represents the dateTime up until which the calling user has read [chatMessages](../resources/chatmessage.md) in a specific chat.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatViewpoint"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatViewpoint",
+ "lastMessageReadDateTime": "String (timestamp)"
+}
+```
+
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
|:|:- | : | |standard| 0 |Default type for a tag. Tags of type standard can be managed in the team by members who have permissions.|
+### teamworkApplicationIdentityType values
+
+|Member|
+|:|
+|aadApplication|
+|bot|
+|tenantBot|
+|office365Connector|
+|outgoingWebhook|
+|unknownFutureValue|
+
+### teamworkConversationIdentityType values
+
+|Member|
+|:|
+|team|
+|channel|
+|chat|
+|unknownFutureValue|
+
+### teamworkUserIdentityType values
+
+|Member|
+|:|
+|aadUser|
+|onPremiseAadUser|
+|anonymousGuest|
+|federatedUser|
+|personalMicrosoftAccountUser|
+|skypeUser|
+|phoneUser|
+|unknownFutureValue|
v1.0 Teamworkapplicationidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamworkapplicationidentity.md
+
+ Title: "teamworkApplicationIdentity resource type"
+description: "Represents an application in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkApplicationIdentity resource type
+
+Namespace: microsoft.graph
++
+Represents an **application** in Microsoft Teams. `teamworkApplicationIdentity` is used to represent bots and outgoing webhooks @mentioned in messages.
++
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|applicationIdentityType|teamworkApplicationIdentityType| Type of application that is referenced. Possible values are: `aadApplication`, `bot`, `tenantBot`, `office365Connector`, and `outgoingWebhook`.|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the application. Optional.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the application.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkApplicationIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkApplicationIdentity",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "applicationIdentityType": "String"
+}
+```
+
v1.0 Teamworkconversationidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamworkconversationidentity.md
+
+ Title: "teamworkConversationIdentity resource type"
+description: "Represents a conversation in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkConversationIdentity resource type
+
+Namespace: microsoft.graph
++
+Represents a **conversation** (chat, team, or channel) in Microsoft Teams.
+
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|conversationIdentityType|teamworkConversationIdentityType|Type of conversation. Possible values are: `team`, `channel`, and `chat`.|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the conversation. Optional.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the conversation.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkConversationIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkConversationIdentity",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "conversationIdentityType": "String"
+}
+```
+
v1.0 Teamworktagidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamworktagidentity.md
+
+ Title: "teamworkTagIdentity resource type"
+description: "Represents a tag in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkTagIdentity resource type
+
+Namespace: microsoft.graph
++
+Represents a **tag** in Microsoft Teams. Tags allow users to quickly connect to subset of users in a team. For details about tag management in Microsoft Teams, see [Manage tags in Microsoft Teams](/microsoftteams/manage-tags).
++
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the tag.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the tag.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkTagIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkTagIdentity",
+ "id": "String (identifier)",
+ "displayName": "String"
+}
+```
+
v1.0 Teamworkuseridentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamworkuseridentity.md
+
+ Title: "teamworkUserIdentity resource type"
+description: "Represents a user in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkUserIdentity resource type
+
+Namespace: microsoft.graph
++
+Represents a **user** in Microsoft Teams.
++
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the user. Optional.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the user. |
+|userIdentityType|teamworkUserIdentityType| Type of user. Possible values are: `aadUser`, `onPremiseAadUser`, `anonymousGuest`, `federatedUser`, `personalMicrosoftAccountUser`, `skypeUser`, and `phoneUser`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkUserIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "userIdentityType": "String"
+}
+```
+
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/channel.md
where files are shared, and where tabs are added.
|isFavoriteByDefault|Boolean|Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with [Create team](../api/team-post.md). Default: `false`.| |email|String| The email address for sending messages to the channel. Read-only.| |webUrl|String|A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.|
-|membershipType|[channelMembershipType](../resources/enums.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and cannot be changed. Possible values are: `standard` - Channel inherits the list of members of the parent team; `private` - Channel can have members that are a subset of all the members on the parent team.
+|membershipType|[channelMembershipType](../resources/enums.md#channelmembershiptype-values)|The type of the channel. Can be set during creation and can't be changed. Possible values are: `standard` - Channel inherits the list of members of the parent team; `private` - Channel can have members that are a subset of all the members on the parent team.
|createdDateTime|dateTimeOffset|Read only. Timestamp at which the channel was created.| ### Instance attributes
v1.0 Chatmessage https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/chatmessage.md
Represents an individual chat message within a [channel](channel.md) or [chat](c
|:|:--|:-| |id|String| Read-only. Unique Id of the message.| |replyToId| string | Read-only. Id of the parent chat message or root chat message of the thread. (Only applies to chat messages in channels, not chats.) |
-|from|[identitySet](identityset.md)| Read only. Details of the sender of the chat message.|
+|from|[chatMessageFromIdentitySet](chatmessagefromidentityset.md)| Read only. Details of the sender of the chat message.|
|etag| string | Read-only. Version number of the chat message. | |messageType|string|The type of chat message. The possible value is: `message`.| |createdDateTime|dateTimeOffset|Timestamp of when the chat message was created.|
The following is a JSON representation of the resource.
{ "id": "string (identifier)", "replyToId": "string (identifier)",
- "from": {"@odata.type": "microsoft.graph.identitySet"},
+ "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"etag": "string", "messageType": "string", "createdDateTime": "string (timestamp)",
v1.0 Chatmessagefromidentityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/chatmessagefromidentityset.md
+
+ Title: "chatMessageFromIdentitySet resource type"
+description: "Represents the sender of a message in a chat or a channel."
+
+localization_priority: Normal
++
+# chatMessageFromIdentitySet resource type
+
+Namespace: microsoft.graph
+
+Represents the sender of a [message](../resources/chatmessage.md) in a chat or a channel. This object may be `null` for a message that has been deleted or sent by the Microsoft Teams internal system; for example, event messages for addition of members.
++
+Inherits from [identitySet](../resources/identityset.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents the application (for instance, bot) that sent the message.|
+|device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not used.|
+|user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents the user that sent the message.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMessageFromIdentitySet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageFromIdentitySet",
+ "user": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "application": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "device": {
+ "@odata.type": "microsoft.graph.identity"
+ }
+}
+```
+
v1.0 Chatmessagemention https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/chatmessagemention.md
The second mention has an `id` attribute of 1, matching the **id** property of t
For a fuller context of the example, see [List channel message replies](../api/chatmessage-list-replies.md#example). ## Properties-
-| Property| Type|Description|
+| Property | Type |Description|
|:|:--|:-| |id|Int32|Index of an entity being mentioned in the specified **chatMessage**. Matches the {index} value in the corresponding `<at id="{index}">` tag in the message body.| |mentionText|string|String used to represent the mention. For example, a user's display name, a team name.|
-|mentioned|[identitySet](identityset.md)|The entity (user, application, team, or channel) that was mentioned. If it was a channel or team that was @mentioned, the identitySet contains a **conversation** property giving the ID of the team/channel, and a **conversationIdentityType** property that represents either the team or channel.|
+|mentioned|[chatMessageMentionedIdentitySet](chatmessagementionedidentityset.md)|The entity (user, application, team, or channel) that was @mentioned.|
## JSON representation
The following is a JSON representation of the resource.
{ "id": 1024, "mentionText": "string",
- "mentioned": {"@odata.type": "microsoft.graph.identitySet"}
+ "mentioned": {"@odata.type": "microsoft.graph.chatMessageMentionedIdentitySet"}
} ```
The following is a JSON representation of the resource.
"suppressions": [] } -->++
v1.0 Chatmessagementionedidentityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/chatmessagementionedidentityset.md
+
+ Title: "chatMessageMentionedIdentitySet resource type"
+description: "Represents the resource @mentioned in a message in a chat or a channel."
+
+localization_priority: Normal
++
+# chatMessageMentionedIdentitySet resource type
+
+Namespace: microsoft.graph
+
+Represents the resource (user, application, or conversation) @mentioned in a [message](../resources/chatmessage.md) in a chat or a channel.
++
+Inherits from [identitySet](../resources/identityset.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents an application (for example, bot) @mentioned in a [message](../resources/chatmessage.md).|
+|conversation|[teamworkConversationIdentity](../resources/teamworkconversationidentity.md)|If present, represents a conversation (for example, team or channel) @mentioned in a [message](../resources/chatmessage.md).|
+|device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not used because it's not supported to @mention devices.|
+|user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents a user @mentioned in a [message](../resources/chatmessage.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMessageMentionedIdentitySet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageMentionedIdentitySet",
+ "user": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "application": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "device": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "conversation": {
+ "@odata.type": "microsoft.graph.teamworkConversationIdentity"
+ }
+}
+```
v1.0 Chatmessagereaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/chatmessagereaction.md
An entity of type `chatMessageReaction` is returned as part of the [Get channel
|:-|:|:| |createdDateTime|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`| |reactionType|String|Supported values are `like`, `angry`, `sad`, `laugh`, `heart`, `surprised`. |
-|user|[identitySet](identityset.md)|The user who reacted to the message.|
+|user|[chatMessageReactionIdentitySet](chatmessagereactionidentityset.md)|The user who reacted to the message.|
## JSON representation
The following is a JSON representation of the resource.
{ "createdDateTime": "String (timestamp)", "reactionType": "String",
- "user": {"@odata.type": "microsoft.graph.identitySet"}
+ "user": {"@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"}
} ```
v1.0 Chatmessagereactionidentityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/chatmessagereactionidentityset.md
+
+ Title: "chatMessageReactionIdentitySet resource type"
+description: "Represents a user that reacted to a message in a chat or a channel."
+
+localization_priority: Normal
++
+# chatMessageReactionIdentitySet resource type
+
+Namespace: microsoft.graph
+
+Represents a **user** that reacted to a [message](../resources/chatmessage.md) in a chat or a channel. Only the `user` property has a value.
++
+Inherits from [identitySet](../resources/identityset.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not set because applications can't react to messages.|
+|device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not set because devices can't react to messages.|
+|user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Details about the user who reacted to the message.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.chatMessageReactionIdentitySet",
+ "user": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "application": {
+ "@odata.type": "microsoft.graph.identity"
+ },
+ "device": {
+ "@odata.type": "microsoft.graph.identity"
+ }
+}
+```
+
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
|user| |application| |system|
+|unknownFutureValue|
+
+### teamworkApplicationIdentityType values
+
+|Member|
+|:|
+|aadApplication|
+|bot|
+|tenantBot|
+|office365Connector|
+|outgoingWebhook|
+|unknownFutureValue|
+
+### teamworkConversationIdentityType values
+
+|Member|
+|:|
+|team|
+|channel|
+|chat|
+|unknownFutureValue|
+
+### teamworkUserIdentityType values
+
+|Member|
+|:|
+|aadUser|
+|onPremiseAadUser|
+|anonymousGuest|
+|federatedUser|
+|personalMicrosoftAccountUser|
+|skypeUser|
+|phoneUser|
|unknownFutureValue|
v1.0 Teamworkapplicationidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teamworkapplicationidentity.md
+
+ Title: "teamworkApplicationIdentity resource type"
+description: "Represents an application in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkApplicationIdentity resource type
+
+Namespace: microsoft.graph
+
+Represents an **application** in Microsoft Teams. `teamworkApplicationIdentity` is used to represent bots and outgoing webhooks @mentioned in messages.
++
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|applicationIdentityType|teamworkApplicationIdentityType| Type of application that is referenced. Possible values are: `aadApplication`, `bot`, `tenantBot`, `office365Connector`, `outgoingWebhook`, and `unknownFutureValue`.|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the application. Optional.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the application.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkApplicationIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkApplicationIdentity",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "applicationIdentityType": "String"
+}
+```
+
v1.0 Teamworkconversationidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teamworkconversationidentity.md
+
+ Title: "teamworkConversationIdentity resource type"
+description: "Represents a conversation in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkConversationIdentity resource type
+
+Namespace: microsoft.graph
+
+Represents a **conversation** (chat, team, or channel) in Microsoft Teams.
+
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|conversationIdentityType|teamworkConversationIdentityType|Type of conversation. Possible values are: `team`, `channel`, `chat`, and `unknownFutureValue`.|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the conversation. Optional.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the conversation.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkConversationIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkConversationIdentity",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "conversationIdentityType": "String"
+}
+```
+
v1.0 Teamworktagidentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teamworktagidentity.md
+
+ Title: "teamworkTagIdentity resource type"
+description: "Represents a tag in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkTagIdentity resource type
+
+Namespace: microsoft.graph
+
+Represents a **tag** in Microsoft Teams. Tags allow users to quickly connect to subset of users in a team. For details about tag management in Microsoft Teams, see [Manage tags in Microsoft Teams](/microsoftteams/manage-tags).
++
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the tag.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the tag.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkTagIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkTagIdentity",
+ "id": "String (identifier)",
+ "displayName": "String"
+}
+```
+
v1.0 Teamworkuseridentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/teamworkuseridentity.md
+
+ Title: "teamworkUserIdentity resource type"
+description: "Represents a user in Microsoft Teams."
+
+localization_priority: Normal
++
+# teamworkUserIdentity resource type
+
+Namespace: microsoft.graph
+
+Represents a **user** in Microsoft Teams.
++
+Inherits from [identity](../resources/identity.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Inherited from [identity](../resources/identity.md). Display name of the user. Optional.|
+|id|String|Inherited from [identity](../resources/identity.md). ID of the user. |
+|userIdentityType|teamworkUserIdentityType| Type of user. Possible values are: `aadUser`, `onPremiseAadUser`, `anonymousGuest`, `federatedUser`, `personalMicrosoftAccountUser`, `skypeUser`, `phoneUser`, and `unknownFutureValue`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.teamworkUserIdentity"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "userIdentityType": "String"
+}
+```
+