An organization owner can change the organization name on SwaggerHub at any time. All organization members will receive an email notification that the organization has been renamed.
Renaming does not affect billing. A renamed organization keeps its billing plan.
Renaming an organization changes the path to its APIs and domains on SwaggerHub, since they live under https://app.swaggerhub.com/apis/orgname. If the APIs use auto-mocking, the mock URLs will also be updated to reflect the new organization name.
Currently, there is no automatic redirection from old URLs to new ones, so any links to the organization APIs, domains, and API mocks will have to be updated manually. This includes references to the organization domains in APIs.
After an organization is renamed, its old account name becomes available in SwaggerHub and any user or organization will be able to use it.
Rename your organization
In SwaggerHub SaaS, SwaggerHub On-Premise 1.22 and later:
Select the organization in the SwaggerHub sidebar, then click Settings next to the organization name.
In earlier SwaggerHub On-Premise versions:
Click your username and select Settings. Switch to the My Organizations tab and click next to the organization name.
Enter a new name for the organization and click Rename to confirm.
Requirements for organization names
- 3 to 20 character long
- Allowed characters:
A..Z a..z 0..9 - _ .
After renaming your organization, go through its APIs and domains that have integrations configured and trigger the integrations manually. You need to do this only once.