Transferring API Ownership

Last modified on September 17, 2021

You can transfer APIs to other users or organizations in SwaggerHub. This operation cannot be reversed unless the new owner has a good will to return the ownership to the former owner.

When a personal API is transferred to a new owner, the previous owner is added as a collaborator with Edit permissions.

Permissions required to transfer ownership

In SwaggerHub SaaS and SwaggerHub On-Premise v. 1.23 and later, users with the following permissions can transfer APIs:

Transfer direction Permissions required
From a personal account Owner
From an organization Organization Owner or Designer with Edit permissions on this API
To an organization Organization Owner or Designer with Create permissions

In earlier SwaggerHub On-Premise versions, only Owners can transfer ownership.

Transfer ownership

SwaggerHub SaaS, SwaggerHub On-Premise v. 1.23 and later

  1. Open the API in the SwaggerHub editor.

  2. Click the API name. This will open the API Info panel.

    Opening the API Info panel
  3. Click  Manage Owner & Project.

    Manage Owner & Project
  4. Select the organization that you want to transfer the API to.

    Selecting the new owner
  5. If the API has integrations configured, you can select the Transfer Integrations check box to transfer the API along with the integrations. Note: This will give the new owner access to the integration settings, including access tokens.

  6. (Optional.) Select a project to add this API to. The list contains existing projects that you are a member of.

  7. Select the Yes, I want to proceed check box.

  8. Click Save.

SwaggerHub On-Premise v. 1.22 and earlier versions

  1. Open the API in the SwaggerHub editor.

  2. Click the API name. This will open the API Info panel.

    Opening the API Info panel
  3. Click Transfer Ownership in the API Info panel.

    Transferring API ownership
  4. Enter the name of the organization or user you want to transfer the API to:

    Transferring API ownership
  5. Enter the API name to confirm the transfer:

    Transferring API ownership: Confirmation
  6. (Optional.) Select the Transfer Integrations check box to give the new owner access to the integration settings and tokens.

  7. Click Transfer API.

See Also

APIs
Creating a New API

Highlight search results