teams chat list¶
Lists all Microsoft Teams chat conversations for the current or a specific user.
Usage¶
m365 teams chat list [options]
Options¶
-t, --type [type]
- The chat type to optionally filter chat conversations by type. The value can be
oneOnOne
,group
ormeeting
. --userId [userId]
- ID of the user. Has to be specified when using application permissions. Specify either
userId
oruserName
, but not both. --userName [userName]
- UPN of the user. Has to be specified when using application permissions. Specify either
userId
oruserName
, but not both. -h, --help [help]
- Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are
options
,examples
,remarks
,response
,full
. Default isfull
. --query [query]
- JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
- Output type.
json,text,csv,md
. Defaultjson
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Examples¶
List all the Microsoft Teams chat conversations of the current user.
m365 teams chat list
List only the one on one Microsoft Teams chat conversations of a specific user retrieved by id.
m365 teams chat list --userId e6296ed0-4b7d-4ace-aed4-f6b7371ce060 --type oneOnOne
List only the group Microsoft Teams chat conversations of a specific user retrieved by mail
m365 teams chat list --userName 'john@contoso.com' --type group
Response¶
[
{
"id": "19:2da4c29f6d7041eca70b638b43d45437@thread.v2",
"topic": null,
"createdDateTime": "2022-11-05T13:06:25.218Z",
"lastUpdatedDateTime": "2022-11-05T13:06:25.218Z",
"chatType": "oneOnOne",
"webUrl": "https://teams.microsoft.com/l/chat/19%3A2da4c29f6d7041eca70b638b43d45437%40thread.v2/0?tenantId=446355e4-e7e3-43d5-82f8-d7ad8272d55b",
"tenantId": "446355e4-e7e3-43d5-82f8-d7ad8272d55b",
"onlineMeetingInfo": null,
"viewpoint": {
"isHidden": false,
"lastMessageReadDateTime": "2022-11-05T13:06:30.582Z"
}
}
]
id topic chatType
--------------------------------------------- ----- --------
19:2da4c29f6d7041eca70b638b43d45437@thread.v2 null oneOnOne
id,topic,chatType
19:2da4c29f6d7041eca70b638b43d45437@thread.v2,,oneOnOne