In SwaggerHub, organizations simplify managing group-owned API definitions and let you develop and publish your APIs under the organization namespace. Each organization contains a collection of public and private APIs and domains. Organization members can see them in the sidebar on the left:
Create and manage organizations
Organization owners can create teams to group members logically and to control access to definitions and projects. See Teams for more information.
To open the organization settings, hover over the organization name in the sidebar and click the Settings button that appears.
In earlier SwaggerHub On-Premise versions, the organization settings button is in the header area on the right.
Organization settings are organized into several pages:
Details – download the audit log, rename or delete the organization.
Members – invite new members, change member roles or delete existing members.
Teams – create or delete teams, change team members.
Standardization – configure API standardization rules for all APIs in your SwaggerHub organization.
Note: In SwaggerHub On-Premise, this feature is available since v. 1.19.2.
Docs Branding – add custom branding to your API documentation.
Plan – change the organization’s billing plan and payment details.
Create APIs and domains under the organization
To create an API or domain on behalf of an organization, select the organization as the Owner of this API or domain. By default, Owners and Designers can create APIs under the organization, but this can be limited to just the Owners.
Member roles and permissions
You can have one of the following roles in an organization: Owner, Designer, or Consumer. Each role has specific permissions. You can see your role in the header of the organization catalog page:
|Note:||By default, Designers have View access to the organization’s APIs and domains created by other Designers. To get Edit access, a Designer needs to be added as a collaborator on an API or domain. Collaborator permissions can be granted to individual members, as well as teams.|
Organization owners can go further and group the organization’s APIs and domains into projects. This will structure the APIs and domains logically, provide easier access to them and simplify management. Project members can see the projects in the sidebar on the left:
An API or domain can belong to multiple projects.
What APIs and domains are visible
By default, all the members can see all of the organization’s APIs and domains – both public and private. This behavior is controlled by the Allow Designers and Consumers to view all the Organization’s Private APIs option in the organization settings. If this option is disabled, Owners can see everything, while Designers and Consumers can see only public APIs and domains.
Note that project members can see both public and private definitions in that project, regardless of the organization settings.
Another way to grant access to private APIs and domains is to add specific users as collaborators on these APIs and domains.
Organization owners can also create teams to group members logically and to control access to definitions and projects easier.
Organizations are billed separately from personal accounts. Every organization requires a paid plan based on the number of users and features you want to use. New organizations start with a free 14-day trial, no credit card is required. After the trial period expires, choose a plan that best suits your organization needs.