Skip to main content

teams chat get

Get a Microsoft Teams chat conversation by id, participants or chat name.

Usage

m365 teams chat get [options]

Options

-i, --id [id]

The ID of the chat conversation. Specify either id, name or participants, but not multiple.

-n, --name [name]

The display name of the chat conversation. Specify either id, name or participants, but not multiple.

-p, --participants [participants]

A comma-separated list of one or more e-mail addresses. Specify either id, name or participants, but not multiple.

-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.

Remarks

The output will not include the chat conversation members or messages. It will just retrieve the conversation details. When using the participants option, the signed-in user will automatically be included as a participant. There's no need to add it to the list manually.

Examples

Get a Microsoft Teams chat conversation by id.

m365 teams chat get --id 19:2da4c29f6d7041eca70b638b43d45437@thread.v2

Get a Microsoft Teams one on one chat conversation, finding it by participant.

m365 teams chat get --participants alexw@contoso.com

Get a Microsoft Teams group chat conversation, finding it by participants.

m365 teams chat get --participants alexw@contoso.com,meganb@contoso.com

Get a Microsoft Teams chat conversation, finding it by display name.

m365 teams chat get --name "Just a conversation"

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