Merge pull request #25680 from microsoftgraph/sthapliyal/appCatalogNote

Add note for app catalog API related to app management policies

Author: Lauragra

api-reference/beta/api/appcatalogs-list-teamsapps.md

@@ -14,15 +14,19 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog.
-
-This includes apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request.
+List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog, including apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request.
 
 > [!NOTE]
 > In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource.
 
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
+> [!IMPORTANT]
+> * Currently, this API is only supported in the user context and not in the admin view.
+> * The Teams apps that this API returns comply with the app management policies established by the admin.
+> * After the Teams apps are published, it typically takes 24-48 hours for the policies to be applied, so some apps might not appear in the API results immediately.
+> * For more information, see [App management policies](/microsoftteams/manage-apps#manage-org-wide-app-settings).
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/v1.0/api/appcatalogs-list-teamsapps.md

@@ -12,14 +12,19 @@ ms.date: 10/17/2024
 
 Namespace: microsoft.graph
 
-List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog.
-This includes apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request.
+List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog, including apps from the Microsoft Teams store and apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request.
 
 > [!NOTE]
 > In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource.
 
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
+> [!IMPORTANT]
+> * Currently, this API is only supported in the user context and not in the admin view.
+> * The Teams Apps that this API returns comply with the app management policies established by the admin.
+> * After the Teams apps are published, it typically takes 24-48 hours for the policies to be applied, so some apps might not appear in the API results immediately.
+> * For more information, see [App management policies](/microsoftteams/manage-apps#manage-org-wide-app-settings).
+
 ## Permissions
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).