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

The details of a version of a teamsApp.

Properties

Property Type Description
id string A unique ID (not the Teams app ID).
teamsAppId string The ID from the Teams app manifest.
publishingState string The published status of a specific version of a Teams app. Possible values are:
submitted — The specific version of the Teams app has been submitted and is under review.
published — The request to publish the specific version of the Teams app has been approved by the admin and the app is published.
rejected — The request to publish the specific version of the Teams app was rejected by the admin.
azureADAppId string The WebApplicationInfo.Id from the Teams app manifest.
displayName string The name of the app provided by the app developer.
version string The version number of the application.
allowedInstallationScopes teamsAppInstallationScope collection A collection of scopes where the Teams app can be installed. Possible values are:
team — Indicates that the Teams app can be installed within a team and is authorized to access that team's data.
groupChat — Indicates that the Teams app can be installed within a group chat and is authorized to access that group chat's data.
personal — Indicates that the Teams app can be installed in the personal scope of a user and is authorized to access that user's data.

Relationships

Relationship Type Description
bot teamworkBot The details of the bot specified in the Teams app manifest.
colorIcon teamsAppIcon The color version of the Teams app's icon.
outlineIcon teamsAppIcon The outline version of the Teams app's icon.

JSON representation

{
  "id": "string",
  "teamsAppId": "string",
  "publishingState": "#microsoft.graph.teamsAppPublishingState",
  "azureADAppId": "string",
  "displayName": "string",
  "version": "string"
}

See also