| title | description | author | ms.localizationpriority | ms.subservice | doc_type |
|---|---|---|---|---|---|
teamsAppInstallation resource type |
Represents a teamsApp installed in a team, a chat, or a user's personal scope. |
AkJo |
medium |
teams |
resourcePageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
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.
| 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. |
| 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). |
| Relationship | Type | Description |
|---|---|---|
| teamsApp | teamsApp | The app that is installed. |
| teamsAppDefinition | teamsAppDefinition | The details of this version of the app. |
The following JSON representation shows the resource type.
{
"consentedPermissionSet": "#microsoft.graph.teamsAppPermissionSet",
"id": "string"
}