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:
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:
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:
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:
Navigate to the APIs tab and click Create an API button, shown in a red circle in the above screen. The following screen opens.
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.
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.
Using the above interface, you can navigate and view various elements related to an API like mocks, monitors, documentation, and so on.
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:
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.
Click the ellipsis (...) next to the API, and select Delete API, as indicated by the red arrow in the following screen:
A delete confirmation message appears:
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.
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:
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: