Merge pull request #296893 from v-albemi/logic-app-api

AI Freshness Edit: Azure API Management

Author: JillGrant615

articles/api-management/import-logic-app-as-api.md

@@ -1,96 +1,93 @@
 ---
-title: Import a Logic App as an API with the Azure portal  | Microsoft Docs
-description: This article shows you how to use API Management to import a Logic App (Consumption) resource as an API.
+title: Import a logic app as an API by using the Azure portal  | Microsoft Docs
+description: Learn how to use Azure API Management to import a logic app (Consumption) resource as an API.
 services: api-management
 author: dlepow
 ms.service: azure-api-management
 ms.topic: how-to
-ms.date: 04/16/2021
+ms.date: 03/27/2025
 ms.author: danlep
+
+#customer intent: As a developer, I want to import a logic app as an API.
 ---
 
-# Import a Logic App as an API
+# Import a logic app as an API
 
 [!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
 
-This article shows how to import a Logic App as an API and test the imported API.
+This article shows how to import a logic app as an API and test the imported API.
 
 [!INCLUDE [api-management-workspace-availability](../../includes/api-management-workspace-availability.md)]
 
 In this article, you learn how to:
 
 > [!div class="checklist"]
 >
-> -   Import a Logic App as an API
+> -   Import a logic app as an API
 > -   Test the API in the Azure portal
 
 > [!NOTE]
-> API Management supports automated import of a Logic App (Consumption) resource. which runs in the multi-tenant Logic Apps environment. Learn more about [single-tenant versus multi-tenant Logic Apps](../logic-apps/single-tenant-overview-compare.md).
+> Azure API Management supports automated import of a Logic App (Consumption) resource, which runs in the multitenant Logic Apps environment. For more information, see [Differences between Standard single-tenant logic apps and Consumption multitenant logic apps](../logic-apps/single-tenant-overview-compare.md).
 
 ## Prerequisites
 
--   Complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md)
--   Make sure there is a Consumption plan-based Logic App resource in your subscription that exposes an HTTP endpoint. For more information, [Trigger workflows with HTTP endpoints](../logic-apps/logic-apps-http-endpoint.md)
+-   Complete the quickstart [Create an Azure API Management instance](get-started-create-service-instance.md).
+-   Make sure there's a Consumption plan-based Logic App resource in your subscription that exposes an HTTP endpoint. For more information, see [Trigger workflows with HTTP endpoints](../logic-apps/logic-apps-http-endpoint.md).
+
+## Import and publish a backend API
 
-[!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-navigate-to-instance.md)]
+1. Navigate to your API Management service in the [Azure portal](https://portal.azure.com).
+1. In the left menu, in the **APIs** section, select **APIs**, and then select **+ Add API**.
 
-## <a name="create-api"> </a>Import and publish a back-end API
+1. Select **Logic App** in the **Create from Azure resource** list:
 
-1. Navigate to your API Management service in the Azure portal and select **APIs** from the menu.
-1. Select **Logic App** from the **Add a new API** list.
+    :::image type="content" source="./media/import-logic-app-as-api/logic-app-select.png" alt-text="Screenshot that shows the Logic App tile.":::
 
-    :::image type="content" source="./media/import-logic-app-as-api/logic-app-select.png" alt-text="Select logic app category":::
+1. Select **Browse** to see the list of logic apps that have HTTP trigger in your subscription. (Logic apps that don't have an HTTP trigger won't appear in the list.)
 
-1. Press **Browse** to see the list of Logic Apps with HTTP trigger in your subscription. 
-    * Logic apps *without* HTTP trigger will not appear in the list.
+    :::image type="content" source="./media/import-logic-app-as-api/browse-logic-apps.png" alt-text="Screenshot that shows the Browse button." lightbox="./media/import-logic-app-as-api/browse-logic-apps.png":::
 
-    :::image type="content" source="./media/import-logic-app-as-api/browse-logic-apps.png" alt-text="Browse for existing logic apps with correct trigger":::
+1. Select the logic app:
 
-1. Select the logic app. 
+    :::image type="content" source="./media/import-logic-app-as-api/select-logic-app-import-2.png" alt-text="Screenshot that shows the Select Logic App to import window." lightbox="./media/import-logic-app-as-api/select-logic-app-import-2.png":::
 
-    :::image type="content" source="./media/import-logic-app-as-api/select-logic-app-import-2.png" alt-text="Select logic app":::
+    API Management finds the Swagger document that's associated with the selected app, fetches it, and imports it.
 
-1. API Management finds the swagger associated with the selected app, fetches it, and imports it.
-1. Add an API URL suffix. 
-    * The suffix uniquely identifies this specific API in this API Management instance.
+1. Add an API URL suffix. The suffix uniquely identifies the API in the API Management instance.
 
-    :::image type="content" source="./media/import-logic-app-as-api/create-from-logic-app.png" alt-text="Finish up fields":::
+    :::image type="content" source="./media/import-logic-app-as-api/create-from-logic-app.png" alt-text="Screenshot that shows values entered in the Create from Logic App window." lightbox="./media/import-logic-app-as-api/create-from-logic-app.png":::
 
-1. If you want the API to be published and available to developers, Switch to the **Full** view and associate it with a **Product**. We use the *"Unlimited"* product in this example. 
-    * You can add your API to a product either during creation or later via the **Settings** tab.
+1. If you want the API to be published and available to developers, switch to the **Full** view and associate the API with a **Product**. This example uses the **Unlimited** product. (You can add your API to a product when you create it or later via the **Settings** tab.)
 
     >[!NOTE]
-    > Products are associations of one or more APIs offered to developers through the developer portal. First, developers must subscribe to a product to get access to the API. Once subscribed, they get a subscription key for any API in that product. As creator of the API Management instance, you are an administrator and are subscribed to every product by default.
+    > Products are associations of one or more APIs offered to developers via the developer portal. First, developers must subscribe to a product to get access to the API. After they subscribe, they get a subscription key for any API in the product. As creator of the API Management instance, you're an administrator and are subscribed to every product by default.
     >
-    > Each API Management instance comes with two default sample products:
+    > In certain tiers, each API Management instance comes with two default sample products:
     > - **Starter**
     > - **Unlimited**
 
-1. Enter other API settings. 
-    * You can set these values during creation or later by going to the **Settings** tab. The settings are explained in the [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
+1. Enter other API settings. You can set these values when you create the API or later by going to the **Settings** tab. The settings are explained in the [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
+
 1. Select **Create**.
 
 ## Test the API in the Azure portal
 
-Operations can be called directly from the Azure portal, which provides a convenient way to view and test the operations of an API.
+You can call operations directly from the Azure portal. This method provides a convenient way to view and test the operations of an API.
 
-:::image type="content" source="./media/import-logic-app-as-api/test-logic-app-api.png" alt-text="Test the logic app":::
+:::image type="content" source="./media/import-logic-app-as-api/test-logic-app-api.png" alt-text="Screenshot that shows the steps for testing an API." lightbox="./media/import-logic-app-as-api/test-logic-app-api.png":::
 
-1. Select the API you created in the previous step.
-2. Press the **Test** tab.
-3. Select the operation you want to test.
+1. Select the API that you created in the previous step.
+1. On the **Test** tab, select the operation that you want to test.
 
     * The page displays fields for query parameters and headers. 
-    * One of the headers is "Ocp-Apim-Subscription-Key", for the product subscription key associated with this API. 
-    * As creator of the API Management instance, you are an administrator already, so the key is filled in automatically.
-
-4. Press **Send**.
+    * One of the headers is `Ocp-Apim-Subscription-Key`. This header is for the product subscription key that's associated with the API. 
+    * As creator of the API Management instance, you're an administrator, so the key is filled in automatically.
 
-    * When the test succeeds, the backend responds with **200 OK** and data.
+1. Select **Send**. When the test succeeds, the backend responds with **200 OK** and data.
 
-[!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-append-apis.md)]
+[!INCLUDE [api-management-append-apis.md](../../includes/api-management-append-apis.md)]
 
 >[!NOTE]
->Every Logic App has **manual-invoke** operation. To comprise your API of multiple logic apps and avoid collision, you need to rename the function. In order to rename the function/API, please navigate to the OpenAPI Specification editor and change the title value.
+>Every Logic App has a `manual-invoke` operation. If you want to combine multiple logic apps in an API, you need to rename the function. To rename the function/API, change the title value in the OpenAPI Specification editor.
 
 [!INCLUDE [api-management-define-api-topics.md](../../includes/api-management-define-api-topics.md)]