Transferring API Ownership
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.