Managing Projects

A project is a group of an organization’s APIs and domains. A single API or domain can belong to multiple projects. Only SmartBear administrators and Organization Owners can add APIs to a project in the Swagger Catalog.

Adding Projects

When you create, import, or fork definitions into an organization, you have the option to add this definition to an existing project or a new project.

To add APIs to an existing project, do the following:

In the Organization API screen, under Project, click Add to Project.
Select the Existing Project option.
The Add API to the existing project dialog box appears.
Select the required project from the Select Project list.
Click Confirm.

The API is added to the project, and you are navigated to the Swagger Studio project settings page. See Project Settings to add and delete APIs and domains from projects.

Tip

You can create new projects, link them with APIs and domains , or invite members to add users to the project in Swagger Catalog

Understanding Project Status

The following are the available project statuses:

Status	Description
View	Appears after adding an API to the project. Only users with the required permissions can view the project.
No Projects	Appears when no API is added to any projects. The user does not have permissions to add an API.
No Permissions	The user does not have access to the project. To gain access, they need to upgrade their plan.

Working with Projects

You can view or edit an API, preview its details, or open it in Swagger Explore. See Swagger Explore documentation for more information. To perform these actions, do the following:

Click the View Icon to view an API. The API details appear in the right pane.
Click Open in Editor icon to write, edit, and preview your API definitions in real time. You are navigated to Swagger Studio Code Editor.
Click Generate MCP Server icon to generate an MCP server for the API definitions. See Generating MCP Server.