Tickets for the 2019 Postman User Conference are available! Get your tickets now before they're gone. Learn more.

Managing APIs

APIs reside in your workspace, just like your collections. This section walks you through how you can create, read, update, and delete APIs in Postman:

Creating an API

You can create an API in the workspace from the sidebar in the Postman app and from the workspaces dashboard. To create an API in the Postman app when no APIs exist in the current workspace, click Create an API button in the sidebar, as illustrated in a red circle in the following screen:

api create4

If you already have created APIs in your workspace, click '+' in the sidebar, as indicated by the red arrow in the above screen. The following tab opens:

api create2

Specify a name for your API.

Note: You can create an API only when you are signed in and online.

Alternatively, you can also create an API from your workspace in the web dashboard as illustrated in the following screen:

api create3

Navigate to the APIs tab and click Create an API button, shown in a red circle in the above screen. The following screen opens.

api create4

Specify a name for your API and click the '☑' adjacent to the name. Your API is created.

You can create different API versions from a specific version of your API. For more information on this, refer to the section Creating API versions.

Note: Free users can create up to three APIs, Pro users up to 10, and Enterprise users up to 100.

Opening and viewing an API

In the sidebar, click the API you want to open. If there are multiple versions of the API, Postman automatically opens the most recently created.

open and view api

Using the above interface, you can navigate and view various elements related to an API like mocks, monitors, documentation, and so on.

Renaming an API

To rename an API, select the API in the sidebar. On the top right corner, click the ellipsis (...), as indicated by the red arrow below:

api create3

Specify a new name and press enter.

You can also rename the versions associated with your APIs. For more information on this, refer to the section Renaming API version tags.

Deleting an API

Click the ellipsis (...) next to the API, and select Delete API, as indicated by the red arrow in the following screen:

api delete

A delete confirmation message appears:

api delete2

When you delete an API, the collections, monitors, mocks, and environments linked to it are not deleted. For a more detailed understanding on this topic, refer to Sharing APIs

You can also delete specific versions of your APIs. For more information on this, refer to the section Deleting an API version.

Removing an API from a workspace

From the Postman app, you can remove an API from the sidebar. Click the ellipsis (...) next to the API you would like to remove, select Remove from workspace and confirm that you would like to remove the API from the current workspace. The API will no longer be visible in the workspace.

When you remove an API from a workspace, the collections, monitors, mocks, and environments linked to it are not removed. For a more detailed understanding on this topic, refer to Sharing APIs.

You will be able to perform all these user actions even from the dashboard, as illustrated in the screen below:

api create5

Commenting on APIs

You can comment on your APIs the same way as you do on your collections. For more information on this, refer to Commenting on Collections


For more information on APIs, see: