Edit and Delete APIs

Publishers can edit and delete APIs. You cannot edit some settings if the API is in use or is a Gateway-published API.
Publishers can add, edit, and delete APIs. You cannot edit some settings if the API is in use or if the API is a Gateway-published API. For more information about how to add APIs, set up the visibility permissions for your organizations, and set up the API management, see Create and Set Permissions for APIs.
Portal Admin
API Owner
Org Publisher
Org Admin
Developer
Guest
Anonymous
Add API
green.png
green.png
green.png
red.png
red.png
red.png
red.png
Read API
green.png
green.png
green.png
green.png
green.png
red.png
red.png
Update API
green.png
green.png
green.png
red.png
red.png
red.png
red.png
Delete API
green.png
green.png
green.png
red.png
red.png
red.png
red.png
Assign Managing Org
green.png
green.png
red.png
red.png
red.png
red.png
red.png
Assign User Permissions
green.png
green.png
red.png
red.png
red.png
red.png
red.png
Assign Consuming Org
green.png
green.png
green.png
red.png
red.png
red.png
red.png
The Org Publisher has publishing permissions only in their assigned organization.
In this article:
Edit an API
Follow these steps:
  1. Log in to
    Layer7 API Developer Portal
    as a Portal Admin.
  2. From the menu bar, select
    Manage
    ,
    APIs
    .
    The APIs are listed on the APIs page.
  3. Select the API that you want to edit.
    The API Details page with information about the selected API opens. By default, the
    Overview
    tab opens, displaying the API location, API type, and tags.
  4. Select the tab associated to the action that you want to do:
    • Spec:
      View the Swagger API documentation and test and explore your API.
      For more information about how to use this tab, see Test and Explore APIs.
    • Deployments:
      View the proxies to which the API is deployed and the type of deployment (On Demand, Automatic, or Scripted).
      This tab is visible to Portal Admins and to users who have
      read
      permissions for APIs, proxies, and API deployments.
      For more information about how to use this tab, see Manage API Deployments.
    • Documentation:
      View the markdown content for the API.
      This tab is visible to Portal Admins.
      For more information about how to use this tab, see Manage API Documents.
  5. Select
    Actions
    , and then select one of the following options based on the action that you want to do:
    • Add API to Application
    • Edit API Details
    • Edit Visibility Permissions
    • Edit Management Permissions
    • Edit Tags
    • Delete API
For more information about how to edit visibility permissions, management permissions, and tags, see Create and Set Permissions for APIs.
Add an API to an Application
You add APIs to applications while adding or editing an application.
For more information about how to add available APIs to an application, see Manage Applications.
Edit API Details
Follow these steps:
  1. From the APIs page, select the API that you want to edit.
    The API details page opens.
  2. Select
    Actions
    , and then select
    Edit API Details
    .
    The
    Details
    page in the API wizard opens.
  3. Edit the following API details, and then select
    Save
    .
    • On the
      Details
      tab, you can add or replace an API definition file from this tab.
      Layer7 API Developer Portal
      supports Swagger 3.0 JSON and WADL XML files (for REST APIs), and WSDL and optional XSD files (for SOAP APIs). You can also change the API name, publish state, version, and the location of the API. If no applications or API groups are using the API, you can also change its API EULA and visibility.
    • On the
      Policy Templates
      tab (Available only for API Portal-published APIs), you can change the policy templates.
    • On the
      Spec Authentication
      tab, for API Portal-published APIs, you can change the default authentication type that the API Explorer applies to the API.
    For more information about the API details that you can edit on the other tabs, see Create and Set Permissions for APIs.
The API details are edited.
Delete an API
Portal Admins and API owners can delete APIs. Deleting an
Layer7 API Developer Portal
-published API from
Layer7 API Developer Portal
also deletes the API on the API proxy when
Layer7 API Developer Portal
and the proxy synchronize.
Deleting
Gateway-published
APIs on
Layer7 API Developer Portal
does not automatically delete the API on the API proxy. Therefore, the API Proxy page shows a synchronization error. Have an API proxy administrator remove the
Set as Portal Managed
assertion from the API.
Follow these steps:
  1. From the APIs page, disable the API:
    1. Select the API that you want to disable.
      The API Details page opens.
    2. Select
      Actions
      , and then select
      Edit API Details
      .
      The
      Details
      tab opens.
    3. Select
      Disable
      as the publish state, and then select
      Save
      .
  2. Determine which applications include the API that you want to delete, and remove the API from each application that includes it:
    1. From the API Details page (with the
      Overview
      tab open), select
      Applications
      .
      The Applications page opens and shows a list of all applications that include the API.
    2. From the drop-down for the application from which you want to remove the API, select
      Edit
      .
      The
      Details
      page in the Application wizard opens.
    3. Select the
      API Management
      tab.
    4. In the
      Selected APIs
      section, select the
      x
      next to the API that you want to remove from the application, and then select
      Save
      .
      If an application includes only one selected API, you can remove the API only by replacing it with another API.
    5. Verify that there are no applications that include the API that are pending approval. If there are applications pending approval, reject them.
  3. Remove the API from each API group that includes it:
    1. From the API Details page (with the
      Overview
      tab open), select
      API Groups
      .
      The API Groups page opens and shows a list of all the API groups that use the API.
    2. From the drop-down for the API group from which you want to remove the API, select
      Edit
      .
      The Edit API Group page opens.
    3. In the
      APIs
      section, under
      Selected APIs
      , select
      Remove
      next to the API that you want to remove from the API group, and then select
      Save
      .
  4. Delete the API. On the API Details page, select the
    Actions
    menu, and then select
    Delete API
    .
  5. (Recommended) If the API is a Gateway-published API, have an API proxy administrator complete the following:
    1. In the Policy Manager, to log in to the API proxy as an administrator.
    2. Remove the
      Set as Portal Managed
      assertion from the API on the proxy.
The API is deleted from
Layer7 API Developer Portal
.