To Classify an API

An unclassified environment is the target environment where all APIs are placed after you upgrade to the API Manager 2.x. APIs you upgrade from the API Manager 1.x to API Manager 2.x reside in the unclassified environment. Also, any API is classified that you didn’t associate with an environment prior to moving to API Manager 2.x. You need to classify any unclassified APIs to govern or otherwise manage the APIs.

Even though API Manager supports tracking APIs with both organization and environment credentials, MuleSoft recommends using environment credentials as the permissions associated to them are more restrictive. You need to restart Mule Runtime after changing credentials. Restarting can cause downtime.

Using credentials from one environment does not allow:

  • Tracking APIs from different environment

  • Tracking APIs from different organizations

If you need to track APIs in either of these ways, use organization credentials.

  1. In API Manager, click the environment control, labeled SANDBOX, in this example:


    If you do not see a suitable environment for classification of the API, create one in Access Management.

  2. In Switch Environment, select Unclassified.

    switch environment
  3. Click Switch.

    A list of unclassified APIs appears.

  4. Click Classify.

  5. In Target Environment, select the environment for the API from the list of environments available to you. For example, select Test.

  6. In Instance Label, optionally type a unique instance name. For example, type abc-api-1

    In environments, APIs can have more than a single instance. Therefore, an instance name is required to uniquely identify it.

    classify instance

A classification suggestion appears in the API list. Click the suggestion and follow the instructions.

In this topic: