| title | teamsAppDefinition resource type |
|---|---|
| description | The details of one version of a teamsApp. |
| author | MSFTRickyCastaneda |
| ms.localizationpriority | medium |
| ms.subservice | teams |
| doc_type | resourcePageType |
| ms.date | 08/16/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
The details of a version of a teamsApp.
| 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. The 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. The 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. |
| 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. |
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"
}