# Add elements to your Private API Network **[Your Private API Network is available with Postman Enterprise plans. Adding APIs to your Private API Network requires the API Builder add-on.](https://www.postman.com/pricing/)** Add elements to your Private API Network to help your team discover and use workspaces, collections, and APIs. You can organize related workspaces, collections, and APIs into folders. [Super Admins](/docs/administration/roles-and-permissions/#team-roles) and [API Network Managers](/docs/administration/roles-and-permissions/#network-roles) can add and organize all workspaces and collections in your Private API Network. Team members can be assigned the [Folder Manager role](/docs/administration/roles-and-permissions/#network-roles) at the folder level, giving them permission to add and organize workspaces and collections in specific folders. If your team has the [API Builder add-on](https://www.postman.com/pricing/), you can also add and organize APIs on your team's Private API Network. Super Admins, API Network Managers, and Folder Managers added to the API Builder add-on can add and organize APIs in your Private API Network based on their permission level. ## 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](/docs/collaborating-in-postman/private-api-network/managing-private-network/). Create new folder in Private Network To create a new folder from your Private API Network view, do the following: 1. Open your [Private API Network](https://go.postman.co/network/private). 2. Select New folder icon **Create Folder** in the left sidebar. If you haven't added any elements yet, you can also select New folder icon **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](#edit-folder-managers). 5. (Optional) Add more folders. Select New folder icon **Add Folder** to add another folder. Select Remove icon **Remove** next to a folder to remove it. 6. Select **Review**. Create folders in Private Network 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 icon **Options > Add folder** next to a folder. You can also select a folder in the left sidebar, then select New folder icon **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](/docs/administration/roles-and-permissions/#network-roles), 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. You can't add Folder Managers to subfolders. 1. Select Options icon **Options > Edit folder managers** next to a folder. You can also select a folder in the left sidebar, then select Options icon **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**. Edit Folder Managers in Private Network ## 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](/docs/collaborating-in-postman/private-api-network/private-network-requests/). Elements can be added from the workbench and with the [Postman API](/docs/collaborating-in-postman/private-api-network/publish-private-network-elements-with-api/). API Editors must be added to [the API Builder add-on](https://www.postman.com/pricing/) to request to add APIs. 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](/docs/administration/roles-and-permissions/). The collections and APIs you add to your Private API Network include the latest changes to these elements. When you add a workspace, collection, or API to your [Private API Network](https://go.postman.co/network/private), it's visible to your Postman team, but isn't visible to [partners](/docs/collaborating-in-postman/using-workspaces/partner-workspaces/overview/). ### Add elements in your Private API Network You can add elements from inside your team's Private API Network. Workspace Editors, Collection Editors, and API Editors can [request to add elements from your Private API Network](/docs/collaborating-in-postman/private-api-network/private-network-requests/#request-to-add-elements-in-your-private-api-network). To add elements from your Private API Network, do the following: 1. Open your [Private API Network](https://go.postman.co/network/private). 2. Select Add icon **Add to Network** in the left sidebar to add elements to the root Home folder. To add elements to a specific folder, select Options icon **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, APIs, and workspaces you want to add. You can search for elements and filter elements by tags. Learn more about adding tags to [collections](/docs/collections/use-collections/collaborate-with-collections/#tag-a-collection), [APIs](/docs/design-apis/api-builder/managing-apis/#tagging-apis), and [workspaces](/docs/collaborating-in-postman/using-workspaces/internal-workspaces/use-workspaces/#tag-a-workspace). If you're adding collections and APIs, you can optionally select environments in their workspace to make sure users have access to environment variables. You can also [edit a collection's or API's environments later](/docs/collaborating-in-postman/private-api-network/managing-private-network/#edit-collections). Not selecting an environment results in a different behavior between collections and APIs. In the case of collections, *No Environment* is available in your Private Network. But, if *No Environment* is selected while adding an API, all environments from the same workspace in which the API resides are available. 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](/docs/collaborating-in-postman/using-version-control/forking-elements/). An API's editor must [publish a version of the API](#publish-specific-api-versions) before you can add it to your Private API Network. You can select an element's name to open it in its workspace in a new tab. Add elements to your Private Network 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](/docs/collaborating-in-postman/private-api-network/private-network-requests/#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. Add workspace to your Private Network 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](/docs/collaborating-in-postman/private-api-network/private-network-requests/#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](/docs/collaborating-in-postman/private-api-network/managing-private-network/#edit-collections). 4. (Optional) Select a folder or create one to keep elements organized. 5. Select **Add Collection**. ### Add an API from the workbench You can add APIs from the workbench. API Editors can [request to add an API from the workbench](/docs/collaborating-in-postman/private-api-network/private-network-requests/#request-to-add-an-api-from-the-workbench). An API's editor must [publish a version of the API](#publish-specific-api-versions) before you can add it to your Private API Network. API Editors must be added to [the API Builder add-on](https://www.postman.com/pricing/) to request to add APIs. To add an API to your Private API Network from the workbench, do the following: 1. Open the API you want to add to your Private API Network. 2. In the API overview, select **Add to API Network**. If you're a Folder Manager, select **Request to Add**. Then select a folder you have permission to manage. Add API to your Private Network The **Add API to the Private API Network** modal opens. 3. (Optional) Select the relevant environment from the dropdown. 4. (Optional) Select a folder or create one to keep elements organized. 5. Select **Add API**. #### Publish specific API versions Publishing a version creates a static representation of your API that consumers can view on your Private API Network. If your API in the Postman API Builder is connected to a Git repository, publish an API version to update your team or public workspace with the latest changes. When you publish a version, the API's definition and collections are synced to the Postman cloud. If you publish an API with an API definition that has syntax errors, your API documentation might not display as expected. To learn more about viewing syntax errors, see [Viewing syntax errors in your API definition](/docs/design-apis/api-builder/develop-apis/validating-elements-against-schema/#viewing-syntax-errors-in-your-api-definition). Learn more about [publishing an API version in the Postman API Builder](/docs/design-apis/api-builder/versioning-an-api/api-versions/). #### Import APIs from a code repository You can make all your existing APIs discoverable on your Private API Network after you import them from a code repository. Learn more about [importing an API](/docs/design-apis/api-builder/importing-an-api/). ## 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. If your team has [the API Builder add-on](https://www.postman.com/pricing/), API Editors added to the API Builder add-on can request to add APIs to your Private API Network. API Network Managers and Folder Managers aren't required to be added to the add-on to review and approve or deny requests. 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](https://go.postman.co/network/private) and select Pending approval icon **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. Approve or deny a request You can also select the request to preview the element before you approve or deny it. Preview element in your Private API Network 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**.