Projects

Last modified on February 26, 2021

A project is a group of an organization’s APIs and domains. You can see the projects under the organization node in the SwaggerHub sidebar.

Projects in SwaggerHub

Projects help organization owners arrange APIs and domains logically and manage their visibility to organization members easier. Projects are useful if your organization works on multiple APIs.

A project can include any number of APIs and domains. An API or domain can belong to multiple projects.

Note: Projects can be created in organizations only. Individual user accounts cannot have projects.

Create and manage projects

Only the organization owners can create, update, and delete projects in an organization.

Availability to members

Projects are visible to the organization owners and to members who are added to these projects. After you added a user to the project, this user can see the organization, project, and project APIs in the left sidebar:

Projects in SwaggerHub

This lets the user jump to the project, API or domain quickly, without searching for it in SwaggerHub.

Project members can see both public and private APIs and domains, regardless of the Allow Designers and Consumers to view all the Organization’s Private APIs organization option.

Note also that, after you added a user to a project, that user gets only the view permissions for the project APIs and domains. If you want a user to comment or edit an API or domain, you should give that user the Comment or Edit permissions for that API or domain. For complete information on this, see Collaborators. For easier management, you can group multiple users into teams and set access permissions for teams.

See Also

Organizations, Projects, and Teams

Highlight search results