teamsAppInstallation resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a teamsApp installed in a team, a chat, or the personal scope of a user. Any bots that are part of the app become part of any team, chat, or user's personal scope that the app is added to.

Note

The id of a teamsAppInstallation resource is not the same value as the id of the associated teamsApp resource.

Methods

Method Return Type Description
List apps in team teamsAppInstallation collection List apps installed in a team.
Get app installed in team teamsAppInstallation Get the specified app installed in a team.
Add app to team None Add (install) an app to a team.
Upgrade app installed in team None Upgrade the app installed in a team to the latest version.
Remove app from team None Remove (uninstall) an app from a team.
List apps for user userScopeTeamsAppInstallation collection List apps installed in the personal scope of a user.
Get app installed for user userScopeTeamsAppInstallation Get the specified app installed in the personal scope of a user.
Add app for user Add (install) an app in the personal scope of a user.
Upgrade installed app for user None Upgrade the app installed in the personal scope of a user to the latest version.
Remove app for user None Remove (uninstall) an app in the personal scope of a user.
List apps in chat teamsAppInstallation collection List apps installed in a chat.
Get app installed in chat teamsAppInstallation Get the specified app installed in a chat.
Add app in chat Add (install) an app to a chat.
Upgrade app installed in chat None Upgrade the app installed in a chat to the latest version.
Remove app from chat None Remove (uninstall) app from a chat.

Properties

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 team's app ID).

Relationships

Relationship Type Description
teamsApp teamsApp The app that is installed.
teamsAppDefinition teamsAppDefinition The details of this version of the app.

JSON representation

The following JSON representation shows the resource type.

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