Skip to 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 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

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"
  }
}

chatType           : oneOnOne
createdDateTime    : 2022-11-05T13:06:25.218Z
id                 : 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
lastUpdatedDateTime: 2022-11-05T13:06:25.218Z
onlineMeetingInfo  : null
tenantId           : 446355e4-e7e3-43d5-82f8-d7ad8272d55b
topic              : null
viewpoint          : {"isHidden":false,"lastMessageReadDateTime":"2022-11-05T13:06:30.582Z"}
webUrl             : https://teams.microsoft.com/l/chat/19%3A2da4c29f6d7041eca70b638b43d45437%40thread.v2/0?tenantId=446355e4-e7e3-43d5-82f8-d7ad8272d55b

id,topic,createdDateTime,lastUpdatedDateTime,chatType,webUrl,tenantId,onlineMeetingInfo,viewpoint
19:2da4c29f6d7041eca70b638b43d45437@thread.v2,,2022-11-05T13:06:25.218Z,2022-11-05T13:06:25.218Z,oneOnOne,https://teams.microsoft.com/l/chat/19%3A2da4c29f6d7041eca70b638b43d45437%40thread.v2/0?tenantId=446355e4-e7e3-43d5-82f8-d7ad8272d55b,446355e4-e7e3-43d5-82f8-d7ad8272d55b,,"{""isHidden"":false,""lastMessageReadDateTime"":""2022-11-05T13:06:30.582Z""}"