The owner of an organization can delete it. Deleting an organization deletes all APIs and domains owned by the organization. This cannot be undone.
The organization name will become available for use by other users or organizations on SwaggerHub. The users who were the members of the deleted organization remain in SwaggerHub and can continue using it personally or as part of another organization.
Note: | In SwaggerHub On-Premise, the default organization cannot be deleted. |
1. Back up organization data
Before deleting an organization and its content, make sure you have a backup of the organization’s API definitions and domains. SwaggerHub lets you download API definitions, and you can also use the SwaggerHub CLI or Registry API to automate the downloads.
2. Cancel the organization’s plan (SwaggerHub SaaS only)
In SwaggerHub SaaS, you must cancel the organization’s plan before deleting the organization. This is a safety measure to protect people from accidental deletion of organizations.
Note: Plan cancellation is not immediate, it will actually happen after the current billing period ends. You can see the scheduled cancellation date in the organization details on the Plan page of the organization settings.
The "Delete organization" button will become available after this date.
3. Delete the organization
-
Click your username and select My Organizations.
-
Click the ellipsis button next to the organization and select Delete Organization.
Note: If you do not see the Delete Organization command, it means the organization’s plan has not been canceled yet, or the cancellation is scheduled for a future date. See Cancel the organization’s plan above for details.
-
Confirm the deletion by entering the organization name and click Delete Organization.
-
Click your username and select Settings.
-
Switch to the My Organizations tab.
-
Click the ellipsis button next to the organization and select Delete Organization.
-
Confirm the deletion by entering the organization name and click Delete Organization.
See Also
Working With Organizations
Creating an Organization
Organization Ownership