Deleting an Organization

Last modified on September 27, 2023

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.

Plan cancellation date

Click the image to enlarge it.

3. Delete the organization

  1. Click your username and select My Organizations.

  2. Click the ellipsis button next to the organization and select Delete Organization.

    Deleting an organization

    Click the image to enlarge it.

    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.

  3. Confirm the deletion by entering the organization name and click Delete Organization.

  1. Click your username and select Settings.

  2. Switch to the My Organizations tab.

  3. Click the ellipsis button next to the organization and select Delete Organization.

    Deleting an organization

    Click the image to enlarge it.

  4. Confirm the deletion by entering the organization name and click Delete Organization.

  1. Click your username and select Settings.

  2. Switch to the My Organizations tab.

  3. Click Delete next to the organization name.

    Deleting an organization

  4. In the dialog that appears, select the confirmation check box and click Delete.

    Confirm deleting the organization

    Click the image to enlarge it.

See Also

Working With Organizations
Creating an Organization
Organization Ownership

Highlight search results