Rename an Organization

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.

Considerations

  • 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

  1. Go to My Hub and click next to the organization name in the sidebar.

    – or –

    In SwaggerHub On-Premise 1.21 and earlier: click your username and select Settings. Then switch to the My Organizations tab and click Details next to the organization name.

  2. Click Edit in the Organization tile.

  3. Enter a new name for the organization and click Save Changes to confirm.

Requirements for organization names

  • 3 to 20 character long

  • Allowed characters: A..Z a..z 0..9 - _ .

  • Case-insensitive

Trigger integrations

Important

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.

See Also

Publication date: