title	teamsApp resource type
description	Represents an app in the Microsoft Teams app catalog.
author	MSFTRickyCastaneda
ms.localizationpriority	high
ms.subservice	teams
doc_type	resourcePageType
ms.date	08/19/2024

teamsApp resource type

Namespace: microsoft.graph

Represents an app in the Microsoft Teams app catalog.

Users can see these apps in the Microsoft Teams Store, and these apps can be installed in teams using the Add app to team method.

Methods

Method	Return Type	Description
List apps in catalog	teamsApp collection	List all the apps in the Microsoft Teams apps catalog.
Publish apps to catalog	teamsApp	Upload an app to your organization's app catalog.
Update app in catalog	teamsApp	Update an app in your organization's app catalog.
Delete app from catalog	None	Remove an app from your organization's app catalog.
Get associated bot	teamworkBot	Get the bot associated with the Teams app.
List apps in channel	teamsApp collection	Get a list of the enabled apps in the specified channel within a team.
Get app in channel	teamsApp	Get an enabled app in the specified channel within a team.
Add app to channel	None	Add a teamsApp that enables an app in the specified channel within a team.
Remove app from channel	None	Remove a teamsApp that disables an app in the specified channel within a team.

Property	Type	Description
displayName	string	The name of the catalog app provided by the app developer in the Microsoft Teams zip app package.
distributionMethod	teamsAppDistributionMethod	The method of distribution for the app. Read-only.
externalId	string	The ID of the catalog provided by the app developer in the Microsoft Teams zip app package.
id	string	The app ID generated for the catalog is different from the developer-provided ID found within the Microsoft Teams zip app package. The externalId value is empty for apps with a distributionMethod type of `store`. When apps are published to the global store, the id of the app matches the id in the app manifest.

Member	Description
store	The app is available to all tenants through the Microsoft Teams app store.
organization	The app is available only in this tenant.
sideloaded	The app is available only to the user or team it's installed to.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

Relationship	Type	Description
appDefinitions	teamsAppDefinition collection	The details for each version of the app.

The following JSON representation shows the resource type.

{
  "externalId": "string",
  "displayName": "string",
  "distributionMethod": "string",
  "id": "string"
}