Editing a consumer organization

You can change the title of an IBM® API Connect consumer organization, and also transfer ownership to a new organization owner.

Before you begin

To complete this task, you must be defined as a member in a Catalog or Space (if Spaces are enabled), and you must be assigned a role that has the Consumer-Org > Manage permission. For more information, see Adding provider organization users and assigning roles and Managing Catalog membership.

About this task

If you transfer ownership, the new organization owner can be an existing user, or you can create a new user. When the ownership changes, the new owner is assigned administration privileges for the organization, and the previous owner has their administration privileges removed. If required, you can restore the privileges to the previous owner as described in Administering members and roles.

If Spaces are enabled in your Catalog, when you edit the details of a consumer organization, the updates are applied to the Catalog and its Spaces. For more information about enabling Spaces, see Using syndication in API Connect.

Procedure

To change the title of a consumer organization, or to transfer ownership to a new organization owner, complete the following steps:

  1. In the navigation pane of the API Manager UI, click Manage icon in the API Manager UI navigation pane Manage, then select the Catalog that you want to work with.
  2. Optional: If Spaces are enabled in the Catalog, select the Space that you want to work with by completing the following steps:
    1. Click the Spaces tab.
    2. Select the Space that you want to work with.
    For more information about enabling Spaces, see Using syndication in API Connect.
  3. In the navigation pane of the API Manager UI, click the Consumers tab.
  4. Click the name of the consumer organization that you want to work with.
  5. To change the title, enter a new title in the Title field, then click Save.
  6. To transfer ownership, select the user registry for the consumer organization owner you want to transfer ownership to.
    The remaining procedure varies according to the type of the selected user registry, as follows:
    • Local User Registry
      1. Select whether the user is an Existing user or a New User.
        • For an existing user, complete the following steps:
          1. Enter the name of an existing API Connect user that has previously been invited to register and has activated their account.
          2. Click Save.
        • For a new user, complete the following steps:
          1. Enter a unique user name for the new user.
          2. Supply an email address, name details, and a password.
          3. Click Save.
    • LDAP
      1. Enter the name of a user that exists in the selected user registry.
      2. Click Save.
    • Authentication URL and OIDC
      1. Enter the name of an existing API Connect user that has previously been invited to register and has activated their account. If the required organization owner has not previously been invited and activated their account, you must ensure they have been invited to the organization first.
      2. Click Save.

Results

If the title of the consumer organization is changed, all application developers that are members of that consumer organization will see the title change reflected in the Developer Portal user interface.