TeamsAppInstallation.ReadForChat
Allows the app to read the Teams apps that are installed in chats the signed-in user can access. Does not give the ability to read application-specific settings.
Permission Details
Read installed Teams apps in chats
Allows the app to read the Teams apps that are installed in chats the signed-in user can access. Does not give the ability to read application-specific settings.
bf3fbf03-f35f-4e93-963e-47e4d874c37a
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
consentedPermissionSet |
teamsAppPermissionSet |
The set of resource-specific permissions consented to while installing or upgrading the teamsApp. |
id |
string |
A unique ID (not the Teams app ID). |
teamsApp |
object |
The app that is installed. |
teamsAppDefinition |
object |
The details of this version of the app. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"consentedPermissionSet": "#microsoft.graph.teamsAppPermissionSet",
"id": "string"
}Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
teamsApp |
teamsApp |
The app that is installed. |
teamsAppDefinition |
teamsAppDefinition |
The details of this version of the app. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
GET
/chats/{chat-id}/installedApps
|
GET
/chats/{chat-id}/installedApps/{app-installation-id}
|
GET
/chats/{chat-id}/permissionGrants
|
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
GET
/chats/{chat-id}/installedApps
|
GET
/chats/{chat-id}/installedApps/{app-installation-id}
|
GET
/chats/{chat-id}/permissionGrants
|
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// 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}"].InstalledApps["{teamsAppInstallation-id}"].GetAsync();const options = {
authProvider,
};
const client = Client.init(options);
let teamsAppInstallation = await client.api('/chats/19:[email protected]/installedApps/MTk6ZDY1NzEzYmM0OThjNGE0MjhjNzFlZjkzNTNlNmNlMjBAdGhyZWFkLnYyIyMwMDAwMTAxNi1kZTA1LTQ5MmUtOTEwNi00ODI4ZmM4YTg2ODc=')
.get();Import-Module Microsoft.Graph.Teams
Get-MgChatInstalledApp -ChatId $chatId -TeamsAppInstallationId $teamsAppInstallationId# 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').installed_apps.by_teams_app_installation_id('teamsAppInstallation-id').get()App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Delegated permissions and search for TeamsAppInstallation.ReadForChat
Grant Admin Consent
Users can consent to this permission during sign-in.