Skip to content

teams chat list

Lists all Microsoft Teams chat conversations for the current user.

Usage

m365 teams chat list [options]

Options

-t, --type [chatType]
The chat type to optionally filter chat conversations by type. The value can be oneOnOne, group or meeting.
-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 is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--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.

m365 teams chat list --type oneOnOne

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