Skip to main 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 options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. 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"
}
}
]
CTRL + M