Manage folders and elements in your Private API Network

Your Private API Network is available on Postman Enterprise plans. Managing APIs on your Private API Network requires the API Builder add-on.

You can manage folders, workspaces, collections, and APIs in your team's Private API Network. You can edit a collection's environments, move folders and elements, rename folders, and remove folders and elements.

Super Admins and API Network Managers can manage all folders, workspaces, and collections in your Private API Network. Folder Managers can manage specific folders and the workspaces and collections in them. Users with the Editor role for a workspace or collection can also manage them on your Private API Network.

If your team has the API Builder add-on, you can also manage APIs on your team's Private API Network. Super Admins, API Network Managers, Folder Managers, and API Editors added to the API Builder add-on can manage APIs in your Private API Network based on their permission level.

Enterprise teams can also assign the API Network Manager role to a user group. For more information about assigning team roles to groups, see Organize users into Postman groups.

You can manage elements within your Private API Network or with the Postman API.

Editing collections

You can change an API or collection's associated environments in your Private API Network.

Select Options > Edit environments next to the collection you'd like to edit. Edit the collection, then select Edit to save your changes.

To change the environment of an API-linked collection, select the parent API, and from the menu options, select Edit environments. The same option is available from the menu in the top right corner.

To add new elements using bulk edits, from the top left menu, select + or Add to Network. The Add elements to the Private API network opens.

You can only edit collections added directly from your Private API Network or the workbench. You can't edit collections added to APIs.

Moving folders and elements

You can move folders and elements in your Private API Network. Select Options next to the folder or element you would like to move, then select Move... or Move element. You can move folders and elements to an existing folder or create a new one. Select Move Folder or Move element to save your changes.

You can also select a folder or element in the left sidebar. Select the more actions icon in the upper-right corner, then select Move... or Move element.

Renaming folders

You can rename folders in your Private API Network. Select Options > Rename next to the folder you'd like to rename. Enter a new name, then select Enter.

Removing folders and elements

You can remove folders and elements from your Private API Network. Select Options next to the folder or element you want to remove, then select Delete or Remove. To confirm, select Remove.

You can also select a folder or element in the left sidebar, select Options in the upper-right corner, then select Delete or Remove.

If you have the Editor role for an element, you can also remove elements in your Private API Network from the workbench. For collections and APIs, open the overview then select Remove. For workspaces, open the overview, select the Settings tab, then select Remove. To confirm, select Remove.

After you remove the element, team members won't have access to it through your Private API Network.