Skip to content

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 or meeting.
--userId [userId]
ID of the user. Has to be specified when using application permissions. Specify either userId or userName, but not both.
--userName [userName]
UPN of the user. Has to be specified when using application permissions. Specify either userId or userName, 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 is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. 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 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