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 designer.
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 on this API |
| To an organization | Organization Owner or Designer |
In earlier SwaggerHub On-Premise versions, only Owners could transfer ownership.
Transfer ownership
SwaggerHub SaaS, SwaggerHub On-Premise v. 1.23 and later
-
Open the API in the SwaggerHub editor.
-
Click the API name. This will open the API Info panel.
-
Click
Manage Owner & Project.
-
Select the organization that you want to transfer the API to.
-
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.
-
(Optional.) Select a project to add this API to. The list contains existing projects that you are a member of.
-
Select the Yes, I want to proceed check box.
-
Click Save.
SwaggerHub On-Premise v. 1.22 and earlier versions
-
Open the API in the SwaggerHub editor.
-
Click the API name. This will open the API Info panel.
-
Click
in the API Info panel.
-
Enter the name of the organization or user you want to transfer the API to:
-
Enter the API name to confirm the transfer:
-
(Optional.) Select the Transfer Integrations check box to give the new owner access to the integration settings and tokens.
-
Click Transfer API.