TeamsAppInstallation.ReadWriteSelfForTeam

Permission Details

Delegated Permission

Allow the app to manage itself in teams

Allows a Teams app to read, install, upgrade, and uninstall itself to teams the signed-in user can access.

Permission ID: 0f4595f7-64b1-4e13-81bc-11a249df07a9

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 `/teams/{id}/installedApps/{id}`
GET `/teams/{team-id}/installedApps`
GET `/teams/{team-id}/permissionGrants`
POST `/teams/{team-id}/installedApps`
POST `/teams/{team-id}/installedApps/{app-installation-id}/upgrade`
DELETE `/teams/{team-id}/installedApps/{app-installation-id}`

Exact Microsoft Learn match

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

Methods
GET `/teams/{id}/installedApps/{id}`
GET `/teams/{team-id}/installedApps`
GET `/teams/{team-id}/permissionGrants`
POST `/teams/{team-id}/installedApps`
POST `/teams/{team-id}/installedApps/{app-installation-id}/upgrade`
DELETE `/teams/{team-id}/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-MgTeamInstalledApp` /teams/{id}/installedApps/{id} Get installed app in team
`Get-MgTeamInstalledApp` /teams/{team-id}/installedApps List apps in team
`Get-MgTeamPermissionGrant` /teams/{team-id}/permissionGrants List permissionGrants of a team
`New-MgTeamInstalledApp` /teams/{team-id}/installedApps Add app to team
`Remove-MgTeamInstalledApp` /teams/{team-id}/installedApps/{app-installation-id} Remove app from team
`Update-MgTeamInstalledApp` /teams/{team-id}/installedApps/{app-installation-id}/upgrade teamsAppInstallation in a team: upgrade

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaTeamInstalledApp` /teams/{id}/installedApps/{id} Get installed app in team
`Get-MgBetaTeamInstalledApp` /teams/{team-id}/installedApps List apps in team
`Get-MgBetaTeamPermissionGrant` /teams/{team-id}/permissionGrants List permissionGrants of a team
`New-MgBetaTeamInstalledApp` /teams/{team-id}/installedApps Add app to team
`Remove-MgBetaTeamInstalledApp` /teams/{team-id}/installedApps/{app-installation-id} Remove app from team
`Update-MgBetaTeamInstalledApp` /teams/{team-id}/installedApps/{app-installation-id}/upgrade teamsAppInstallation: upgrade

Code Examples

C# / .NET SDK

Add app to team

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new TeamsAppInstallation
{
	AdditionalData = new Dictionary<string, object>
	{
		{
			"[email protected]" , "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].InstalledApps.PostAsync(requestBody);

JavaScript

Add app to team

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const teamsAppInstallation = {
   '[email protected]':'https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a'
};

await client.api('/teams/87654321-0abc-zqf0-321456789q/installedApps')
	.post(teamsAppInstallation);

PowerShell

Add app to team

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

$params = @{
	"[email protected]" = "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

New-MgTeamInstalledApp -TeamId $teamId -BodyParameter $params

Python

Add app to team

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.teams_app_installation import TeamsAppInstallation
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TeamsAppInstallation(
	additional_data = {
			"teams_app@odata_bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a",
	}
)

result = await graph_client.teams.by_team_id('team-id').installed_apps.post(request_body)

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.ReadWriteSelfForTeam

4

Grant Admin Consent

This delegated permission requires admin consent.