Skip to main content

teams chat get

Gets 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, permissions, 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"
  }
}