Edit

teamsAppInstallation resource type

  • Article

Namespace: microsoft.graph

Represents a teamsApp installed in a team or the personal scope of a user. Any bots that are part of the app will become part of any team 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 installed 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 installed 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 app installed 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.

Properties

Property Type Description
id string A unique ID (not the Teams app ID).
consentedPermissionSet teamsAppPermissionSet The set of resource-specific permissions consented to while installing or upgrading the teamsApp.

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 is a JSON representation of the resource.

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

See also