3.8. Delete an API

Deleting an API or its versions is allowed in the following cases:

  • an API can be deleted when all of its versions are in their Retired States

  • an API Version can be deleted if the API Version is in its Retired State

  • an API Version can be deleted if the API Version is in its Draft State (never submitted and approved)

Common Tasks

Following are the common tasks identified in this section:

  • Navigating to the APIs screen

    To navigate to the APIs screen:

    • In the main navigation menu, click APIs.

    Navigation menu

    Fig. 3.223 Navigation menu

    The APIs screen displays.

    APIs screen

    Fig. 3.224 APIs screen

  • Navigating to the API Configuration screen

    To navigate to the REST API Configuration screen:

    1. Navigate to the APIs screen.

    2. In the APIs screen, click the row that has the REST API you want to configure. The REST API Configuration screen displays.

    API Configuration screen

    Fig. 3.225 API Configuration screen

    To navigate to the SOAP API Configuration screen:

    1. Navigate to the APIs screen.

    2. In the APIs screen, click the row that has the SOAP API you want to configure. The SOAP API Configuration screen displays.

    SOAP API Configuration screen

    Fig. 3.226 SOAP API Configuration screen

To delete an API version:

  1. Navigate to the API Configuration screen.

  2. Click the Action icon control. The API Action menu displays. The menu options will have the “Delete Version” menu option under STATUS if the API version is in its Retired state.

API Action menu

Fig. 3.227 API Action menu

  1. Click Delete Version to delete the API version.

    A warning message appears asking you to confirm your action.

    Warning for Deleting an API Version

    Fig. 3.228 Warning for Deleting an API Version

  2. Click OK to proceed or click Cancel to exit.

A notification message, “API is successfully deleted” displays. The API version is removed from the API version list.

Note

Deleting a Version from the API Action menu deletes only that version of the API.

To delete an API:

  1. Navigate to the APIs screen.

  2. In the APIs screen, in the row that has the API you want to delete, click the delete icon delete. A warning message appears asking you to confirm your action.

    Warning for Deleting an API

    Fig. 3.229 Warning for Deleting an API

  3. Click OK to proceed or click Cancel to exit.

Note

The delete icon appears only for API’s that have all of its API versions in their Retired States and also for the newly created API’s which are not yet published or approved.

Next Steps

After creating and editing APIs, you need to bundle these APIs into Packs so they can be put up on the API Store for consumption. In the next section, you will learn to create an API Pack.