Edit

Share via

Edit an API

APPLIES TO: All API Management tiers

This article describes how to use Azure API Management to edit an API.

  • You can add, rename, or delete operations in the Azure portal.
  • You can edit your API's swagger.

Prerequisites

Go to your API Management instance

  1. In the Azure portal, search for and select API Management services:

    Screenshot that shows API Management services in the search results.

  2. On the API Management services page, select your API Management instance:

    Screenshot that shows an API Management instance on the API Management services page.

Edit an operation

  1. Under APIs, select APIs.
  2. Select an API that you have imported.
  3. Select the Design tab.
  4. Select the operation that you want to edit.
  5. To rename the operation, select the pencil button in the Frontend pane.

Screenshot that shows the process for editing an API in API Management.

Update the swagger

You can update your API's swagger from the Azure portal by completing these steps:

  1. On the APIs page, select All operations.

  2. Select the pencil button in the Frontend pane.

    Screenshot that shows the pencil button in the Frontend pane.

    Your API's swagger appears.

    Screenshot that shows an API's swagger.

  3. Update the swagger.

  4. Select Save.

Caution

If you're editing a non-current revision of an API, you can't change the following properties:

  • Name
  • Type
  • Description
  • Subscription required
  • API version
  • API version description
  • Path
  • Protocols

If your edits change any of these properties in a non-current revision, you'll see the error message Can't change property for non-current revision.

Related content