Manage API Groups

As an administrator or API owner, you can add, edit, deprecate, and delete API groups. API groups are collections of APIs that organization administrators and developers can consume. You can group your APIs across your organizational and business boundaries by adding them to API groups. Organization administrators and developers can consume API groups while adding and editing their applications.
apip43
As an administrator or API owner, you can add, edit, deprecate, and delete API groups. API groups are collections of APIs that organization administrators and developers can consume. You can group your APIs across your organizational and business boundaries by adding them to API groups. Organization administrators and developers can consume API groups while adding and editing their applications.
For more information about the roles and permissions for managing API groups, see Get Started - User Types, Roles and Permissions.
You can also manage your API groups by way of the Portal API (PAPI) or use this API in your scripts for managing API groups.
For more information about the Portal API, see Portal API (PAPI).
In this article:
Create API Groups
  1. Select the 
    Services
    icon.
  2. Select 
    Publish
    .
  3. Select
    API Groups
    from the menu bar at the top of the page.
    The API Groups page opens.
  4. Select
    Add API Group
    .
    The
    Add API Group
    page opens.
  5. In the
    Group Details
     section of the page, complete the following fields:
    API Group Name
    The name of the API group you are creating.
    Unique:
     Yes
    Maximum length:
     255
    Required:
     Yes
    Description
    The description of the API group you are creating.
    Maximum length:
     255
    Required:
     No
  6. Add and remove APIs to your API group. In the APIs section of the page, the Available APIs section lists the APIs that you can add to your API group. You can only add enabled APIs to your API group. To add an API to your API group, next to the API that you want to add to your API group, select 
    Add
    .
    Because this API group is new and you have not added APIs to your API group yet, the Selected APIs
     
    section is empty.
  7. Select 
    Save
    .
Your API group is created. See your group in the list on the
API Groups
page. The API group is enabled by default.
View your List of API Groups
You can view your list of API groups on the API Groups page. The following information is displayed:
  • The state of each API group:
  • The number of applications that have added the API group
  • The number of organizations that are associated to the API group
Edit API Groups
You can edit your API groups, including those API groups an organization administrator or developer has added to their application.
You can edit your API group in the following ways:
  • Add APIs to your API group.
  • Remove APIs from your API group. 
  • Change the API group name.
  • Change the API group state.
Add and Remove APIs from API Groups
You can add public and private APIs to your API group.
Follow these steps:
  1. From the API Groups page, on the Actions menu next to the API group you want to delete, select 
    Edit
    .
    The Edit API Group page appears.
    If you already added an API to your API group and the state of the API changes from enabled to disabled, the following message appears at the top of the
    Edit API Group
    page:
    This API Group contains disabled APIs and will not be available for applications of same organizations.
    Applications within your organization cannot use API groups that include disabled APIs. Applications within all other organizations can use API groups that include disabled APIs.
    Best Practice: 
    Remove disabled APIs from your API group.
  2. Edit the details for the API Group:
    • In the APIs section of the page, the 
      Selected APIs 
      section lists the APIs that you have added to your API group. To remove an API from your API group, next to the API you want to remove, select 
      Remove
      .
      The API is removed from the 
      Selected APIs 
      section.
      Once an API is linked to an application by way of its API group, it cannot be removed. To remove, you must first unlink the API Group from the application.
    • In the APIs section of the page, the 
      Available APIs 
      section lists the APIs that you can add to your API group. Only enabled APIs are listed. To add an API to your API group, next to the API that you want to add to your API group, select 
      Add
      .
      The API is added to the 
      Selected APIs 
      section.
  3. Select
    Save
    .
Your changes to the API group are saved.
Edit the State on an API Group
You can change the state of your API groups to enabled or deprecated. From the Edit API Group page, in the Group Details section of the page, select
Enabled
or
Deprecated
, and then select
Save
.
Delete API Groups
Prerequisite:
 An organization administrator or developer has not added the API group to an application (the application is not using the API group).
  1. From the API Groups page, on the Actions menu next to the API group you want to delete, select 
    Delete
    .
  2. Select
    Ok
    to confirm the deletion of the API group.
The API group is deleted and no longer displays on the API Groups page.