ESC
Type to search...

TeamsAppInstallation.ReadWriteSelectedForUser

Export JSON
Export CSV
Copy URL
Print
Delegated Read/Write User Scope

Allows the app to read, install, upgrade, and uninstall selected Teams apps installed for the signed in user. Does not give the ability to read application-specific settings.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission Admin consent required

Manage selected Teams apps installed for a user

Allows the app to read, install, upgrade, and uninstall selected Teams apps installed for the signed in user. Does not give the ability to read application-specific settings.

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 /users/{user-id | user-principal-name}/teamwork/installedApps
GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/chat
POST /users/{user-id | user-principal-name}/teamwork/installedApps
POST /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/upgrade
DELETE /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
Exact Microsoft Learn match

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

Methods
GET /users/{user-id | user-principal-name}/teamwork/installedApps
GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/chat
POST /users/{user-id | user-principal-name}/teamwork/installedApps
POST /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/upgrade
DELETE /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps
List apps installed for user
Get-MgUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
Get installed app for user
Get-MgUserTeamworkInstalledAppChat /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/chat
Get chat between user and teamsApp
New-MgUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps
Install app for user
Remove-MgUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
Uninstall app for user
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps
List apps installed for user
Get-MgBetaUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
Get installed app for user
Get-MgBetaUserTeamworkInstalledAppChat /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/chat
Get chat between user and teamsApp
New-MgBetaUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps
Install app for user
Remove-MgBetaUserTeamworkInstalledApp /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
Uninstall app for user

Code Examples

C# / .NET SDK
Get chat between user and teamsApp
// 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.Users["{user-id}"].Teamwork.InstalledApps["{userScopeTeamsAppInstallation-id}"].Chat.GetAsync();
JavaScript
Get chat between user and teamsApp
const options = {
	authProvider,
};

const client = Client.init(options);

let chat = await client.api('/users/f32b83bb-4fc8-4db7-b7f5-76cdbbb8aa1c/teamwork/installedApps/ZjMyYjgzYmItNGZjOC00ZGI3LWI3ZjUtNzZjZGJiYjhhYTFjIyMyMmY3M2JiZS1mNjdhLTRkZWEtYmQ1NC01NGNhYzcxOGNiMmI=/chat')
	.get();
PowerShell
Get chat between user and teamsApp
Import-Module Microsoft.Graph.Teams

Get-MgUserTeamworkInstalledAppChat -UserId $userId -UserScopeTeamsAppInstallationId $userScopeTeamsAppInstallationId
Python
Get chat between user and teamsApp
# 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.users.by_user_id('user-id').teamwork.installed_apps.by_user_scope_teams_app_installation_id('userScopeTeamsAppInstallation-id').chat.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.ReadWriteSelectedForUser

4

Grant Admin Consent

This delegated permission requires admin consent.