Manage folders and elements in the Private API Network

The Private API Network is available on Postman Enterprise plans.

You can manage folders and elements in the Private API Network. You can edit a collection's environments, move folders and elements, rename folders, and remove folders and elements from the network.

Super Admins and API Network Managers can manage all folders and elements in your Private API Network. You can assign team members the Folder Manager role at the folder level, giving them permission to manage specific folders and the elements in them. Users with the Editor role for an element can also manage the element.

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

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

Editing collections

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

Select the more actions icon More actions icon next to the collection you would like to edit from the network, then select Edit environments. 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.

Add elements to the Private Network

You can only edit collections added directly from the 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 the Private API Network. Select the more actions icon More actions icon next to the folder or element you would like to move in the network, 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 sidebar. Select the more actions icon More actions icon in the upper-right corner, then select Move... or Move element.

Renaming folders

You can rename folders in the Private API Network. Select the more actions icon More actions icon next to the folder you would like to rename, then select Rename. Enter a new name, then press Enter.

Removing folders and elements

You can remove folders and elements from the Private API Network. Select the more actions icon More actions icon next to the folder or element you want to remove from the network, then select Delete or Remove. To confirm that you want to remove an element from the network, select Remove.

You can also select a folder or element in the sidebar. Select the more actions icon More actions icon 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 Workspace settings icon Workspace Settings, then select Remove. To confirm, select Remove.

Remove collection in Private API Network from workbench

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

Last modified: 2023/09/15