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. |
| authorization | teamsAppAuthorization | Authorization requirements specified in the Teams app manifest. |
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. |
| dashboardCards | teamsAppDashboardCardDefinition collection | Dashboard cards specified in the Teams app manifest. |
| outlineIcon | teamsAppIcon | The outline version of the Teams app's icon. |
JSON representation
The following JSON representation shows the resource type.
{
"id": "string",
"teamsAppId": "string",
"publishingState": "#microsoft.graph.teamsAppPublishingState",
"azureADAppId": "string",
"displayName": "string",
"version": "string",
"authorization": "#microsoft.graph.teamsAppAuthorization"
}