Rename an Organization

An organization owner can change the organization name on API Hub for Design 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.Plans and Billing

  • Renaming an organization changes the path to its APIs and domains on API Hub for Design, 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.API Auto Mocking

  • 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 API Hub for Design and any user or organization will be able to use it.

Rename your organization

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

    – or –

    In API Hub for Design 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.Integrations

See Also

Publication date: