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"
}