teamsApp resource type

Namespace: microsoft.graph


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


Method Return Type Description
List apps in catalog teamsApp collection List all the apps in the Microsoft Teams apps catalog.
Upload app 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 bot associated with app in catalog teamworkbot Get the bot associated with the Teams app.


Property Type Description
id string The catalog app's generated app ID (different from the developer-provided ID in the Microsoft Teams zip app package).
externalId string The ID of the catalog provided by the app developer in the Microsoft Teams zip app package.
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.

teamsAppDistributionMethod values

Member Value Description
store 0 The app is available to all tenants through the Microsoft Teams app store.
organization 1 The app is available only in this tenant.
sideloaded 2 The app is available only to the user/team its installed to.


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

JSON representation

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

See also