TeamsAppInstallation.ReadForChat

Permission Details

Delegated Permission

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.

Permission ID: bf3fbf03-f35f-4e93-963e-47e4d874c37a

Properties

Microsoft Graph v1.0 exact-category-docs

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

Microsoft Graph v1.0 exact-category-docs

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

JSON representation

{
  "consentedPermissionSet": "#microsoft.graph.teamsAppPermissionSet",
  "id": "string"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

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

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}/installedApps`
GET `/chats/{chat-id}/installedApps/{app-installation-id}`
GET `/chats/{chat-id}/permissionGrants`

Exact Microsoft Learn match

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`

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgChatInstalledApp` /chats/{chat-id}/installedApps List apps in chat
`Get-MgChatInstalledApp` /chats/{chat-id}/installedApps/{app-installation-id} Get installed app in chat
`Get-MgChatPermissionGrant` /chats/{chat-id}/permissionGrants List permissionGrants of a chat

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaChatInstalledApp` /chats/{chat-id}/installedApps List apps in chat
`Get-MgBetaChatInstalledApp` /chats/{chat-id}/installedApps/{app-installation-id} Get installed app in chat
`Get-MgBetaChatPermissionGrant` /chats/{chat-id}/permissionGrants List permissionGrants of a chat

Code Examples

C# / .NET SDK

Get installed app in 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}"].InstalledApps["{teamsAppInstallation-id}"].GetAsync();

JavaScript

Get installed app in chat

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

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

PowerShell

Get installed app in chat

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Get-MgChatInstalledApp -ChatId $chatId -TeamsAppInstallationId $teamsAppInstallationId

Python

Get installed app in 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').installed_apps.by_teams_app_installation_id('teamsAppInstallation-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 Delegated permissions and search for TeamsAppInstallation.ReadForChat

4

Grant Admin Consent

Users can consent to this permission during sign-in.

Frequently asked questions

What is the TeamsAppInstallation.ReadForChat Microsoft Graph permission?

TeamsAppInstallation.ReadForChat is a delegated permission in the Microsoft Graph API, grouped under the TeamsAppInstallation category. 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. It grants read-only access to resources. Users can consent to this permission during sign-in. It is mapped to the Microsoft Graph teamsappinstallation resource type. 6 documented Microsoft Graph REST methods require it. 6 Microsoft Graph PowerShell commands are documented for it.

Is TeamsAppInstallation.ReadForChat an application or a delegated permission?

TeamsAppInstallation.ReadForChat is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.

Does TeamsAppInstallation.ReadForChat require admin consent?

Users can consent to this permission during sign-in.

What is the permission ID (GUID) for TeamsAppInstallation.ReadForChat?

For TeamsAppInstallation.ReadForChat, the delegated (OAuth2 scope) ID is bf3fbf03-f35f-4e93-963e-47e4d874c37a. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.