Add elements to your Private API Network

Add elements to your Private API Network to help your team discover and use workspaces, collections, and APIs. You can organize related workspaces and collections into folders.

Super Admins and API Network Managers can add and organize all workspaces and collections in your Private API Network. Team members can be assigned the Folder Manager role at the folder level, giving them permission to add and organize workspaces and collections in specific folders.

Organize with folders

The left sidebar navigation displays the folder structure for your Private API Network. API Network Managers can drag elements and subfolders into different folders. You can add descriptions to folders to describe elements within the folders. You can also add Folder Managers to specific folders. To learn more about managing folders, see Manage folders and elements in your Private API Network.

To create a new folder from your Private API Network view, do the following:

1. Open your Private API Network.

2. Select Create Folder in the left sidebar. If you haven’t added any elements yet, you can also select Create Folders on the right from your Private API Network’s overview page.

3. Give the folder a name.

4. (Optional) Add Folder Managers to the folder. You can also add Folder Managers to a folder later. To learn more, see Edit Folder Managers.

5. (Optional) Add more folders. Select Add Folder to add another folder. Select Remove next to a folder to remove it.

6. Select Review.

   

7. Review your folders and Folder Managers, and then select Create Folders.

Add subfolders

To add a subfolder to an existing folder, do the following:

1. Select Options > Add folder next to a folder. You can also select a folder in the left sidebar, then select Create Folder in the upper-right corner.

   You can create up to four levels of subfolders in each folder.

2. Enter a name for the folder. Optionally, you can add a description for the subfolder.

3. Select Create Folder.

Edit Folder Managers

API Network Managers can assign team members the Folder Manager role, giving them permission to manage specific folders and the elements in them. Folder Managers can also assign other team members the Folder Manager role in folders they have permission to manage.

1. Select Options > Edit folder managers next to a folder. You can also select a folder in the left sidebar, then select Options > Edit folder managers in the upper-right corner.

2. Enter the name, email, or group name you want to assign as a Folder Manager for the folder.

3. Select Save Changes.

   

Add elements

API Network Managers can add elements to a Private API Network. Folder Managers can add elements to folders they have permission to manage. Workspace Editors, Collection Editors, and API Editors must request to add elements to your Private API Network. Elements can be added from the workbench and with the Postman API.

To add an element to your Private API Network, it must be in a team or public workspace. You can’t add an element to your Private API Network unless all team members have at least view access to the element. Learn more about team roles and permissions.

The collections you add to your Private API Network include the latest changes to these elements.

Add elements in your Private API Network

You can add elements from inside your team’s Private API Network. Workspace Editors and Collection Editors can request to add elements from your Private API Network.

To add elements from your Private API Network, do the following:

1. Open your Private API Network.

2. Select Add to Network in the left sidebar to add elements to the root Home folder. To add elements to a specific folder, select Options > Add elements next to a folder.

   You can select a folder in the left sidebar, then select Add to Folder in the upper-right corner.

3. Select the collections and workspaces you want to add. You can search for elements and filter elements by tags. Learn more about adding tags to collections and workspaces.

   If you’re adding collections, you can optionally select environments in their workspace to make sure users have access to environment variables. You can also edit a collection’s environments later.

   You can select Added elements in the upper-right corner to show elements already added to your Private API Network. You can select the Collections tab and then Forks in the upper-right corner to show forked collections.

1. Select Review.
2. Review your selections, and then select Add to Network.

Add a workspace from the workbench

You can add workspaces from the workbench. Workspace Editors can request to add a workspace from the workbench.

To add a workspace to your Private API Network from the workbench, do the following:

1. Open the workspace you want to add to your Private API Network.

2. In the workspace overview, select the Settings tab.

3. Select Add to Network.

   If you’re a Folder Manager, select Request to Add. Then select a folder you have permission to manage.

   

4. (Optional) Select a folder or create one to keep elements organized.

5. Select Add workspace.

Add a collection from the workbench

You can add collections from the workbench. Collection Editors can request to add a collection from the workbench.

To add a collection to your Private API Network from the workbench, do the following:

1. Open the collection you want to add to your Private API Network.

2. In the collection overview, select Publish to API Network > Publish Collection.

   If you’re a Folder Manager, select Request to Publish. Then select a folder you have permission to manage.

3. (Optional) Select an environment to make sure users have access to environment variables. You can also edit a collection’s environments later. To learn more, see Edit collections.

4. (Optional) Select a folder or create one to keep elements organized.

5. Select Add Collection.

Review requests to add elements

API Network Managers can review requests to add elements to your Private API Network. Folder Managers can review requests to add elements to folders they have permission to manage.

When an Editor requests to add an element to your team’s Private API Network, Postman emails you and sends you an in-app notification. For the list of all the pending requests, open your Private API Network and select Pending requests in the left sidebar.

Pending requests include the element type, the user who submitted the request, the date they submitted it on, a link to view the element in its workspace, the folder they want to add the element to, and an optional note from the requesting user. If the element is an API, pending requests also include syntax errors and rule violations if they’re present in the API definition.

You can also select the request to preview the element before you approve or deny it.

To approve a request, do the following:

1. Select Approve.
2. (Optional) Select a folder or create one to keep elements organized.
3. Select Approve Request.

To deny a request, do the following:

1. Select Deny.
2. Write a note to the Editor who submitted the request explaining why you are denying their request.
3. Select Deny Request.