Chat.ReadBasic.WhereInstalled | Graph Permissions

Permission Details

Application Permission

Read names and members of all chat threads where the associated Teams application is installed.

Allows the app to read names and members of all one-to-one and group chats in Microsoft Teams where the associated Teams application is installed, without a signed-in user.

Permission ID: 818ba5bd-5b3e-4fe0-bbe6-aa4686669073

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`chatType`	`chatType`	Specifies the type of chat. The possible values are: group, oneOnOne, meeting, unknownFutureValue.
`createdDateTime`	`dateTimeOffset`Nullable	Date and time at which the chat was created. Read-only.
`id`	`String`	The chat's unique identifier. Read-only.
`isHiddenForAllMembers`	`Boolean`Nullable	Indicates whether the chat is hidden for all its members. Read-only.
`lastUpdatedDateTime`	`dateTimeOffset`Nullable	Date and time at which the chat was renamed or the list of members was last changed. Read-only.
`onlineMeetingInfo`	`teamworkOnlineMeetingInfo`	Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only.
`tenantId`	`String`Nullable	The identifier of the tenant in which the chat was created. Read-only.
`topic`	`String`Nullable	(Optional) Subject or topic for the chat. Only available for group chats.
`viewpoint`	`chatViewpoint`	Represents caller-specific information about the chat, such as the last message read date and time. This property is populated only when the request is made in a delegated context.
`webUrl`	`String`Nullable	The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.
`installedApps`	`teamsAppInstallation collection`	A collection of all the apps in the chat. Nullable.
`lastMessagePreview`	`object`	Preview of the last message sent in the chat. Null if no messages were sent in the chat. Currently, only the list chats operation supports this property.
`members`	`conversationMember collection`	A collection of all the members in the chat. Nullable.
`messages`	`chatMessage collection`	A collection of all the messages in the chat. Nullable.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps for the chat.

Showing 15 of 17 properties.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "createdDateTime": "dateTimeOffset",
  "chatType": "string",
  "id": "string (identifier)",  
  "isHiddenForAllMembers": "Boolean",
  "lastUpdatedDateTime": "dateTimeOffset",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  },
  "tenantId": "string",
  "topic": "string",
  
  "viewpoint": {
    "@odata.type": "microsoft.graph.chatViewpoint"
  },
  "webUrl": "string",
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`installedApps`	`teamsAppInstallation collection`	A collection of all the apps in the chat. Nullable.
`lastMessagePreview`	`chatMessageInfo`	Preview of the last message sent in the chat. Null if no messages were sent in the chat. Currently, only the list chats operation supports this property.
`members`	`conversationMember collection`	A collection of all the members in the chat. Nullable.
`messages`	`chatMessage collection`	A collection of all the messages in the chat. Nullable.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps for the chat.
`pinnedMessages`	`pinnedChatMessageInfo collection`	A collection of all the pinned messages in the chat. Nullable.
`tabs`	`teamsTab collection`	A collection of all the tabs in the chat. Nullable.
`chatType`	`chatType`	Related chatType data exposed by this resource.
`operations`	`teamsAsyncOperation collection`	A collection of all the Teams async operations that ran or are running on the chat. Nullable.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/chats/{chat-id}`
GET `/me/chats/{chat-id}`
GET `/users/{user-id \| user-principal-name}/chats/{chat-id}`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/chats/{chat-id}`
GET `/me/chats/{chat-id}`
GET `/users/{user-id \| user-principal-name}/chats/{chat-id}`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgChat` /me/chats/{chat-id} Get chat
`Get-MgUserChat` /me/chats/{chat-id} Get chat

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaChat` /me/chats/{chat-id} Get chat
`Get-MgBetaUserChat` /me/chats/{chat-id} Get chat

Code Examples

C# / .NET SDK

Get chat

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Chats["{chat-id}"].GetAsync();

JavaScript

Get chat

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let chat = await client.api('/chats/19:[email protected]')
	.get();

PowerShell

Get chat

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Get-MgChat -ChatId $chatId

Python

Get chat

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.chats.by_chat_id('chat-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions and search for Chat.ReadBasic.WhereInstalled

4

Grant Admin Consent

Application permissions always require admin consent.