Forking a Collection to Build Faster API Demos in Postman

Quick Overview

The video demonstrates how to fork a public Postman API collection, specifically the Yelp Openings API, into a new private workspace using Postman's API Network and Agent Mode to rapidly build and iterate on API demo projects, allowing developers to customize and experiment without affecting the original collection.

Key Points: The primary goal is to fork the public Yelp Openings API collection from the Postman API Network into a new private workspace called "Notion Demo Project Template". The participants establish a new internal Postman workspace to house the forked collection, inviting each other as administrators for collaboration. The Yelp Openings API collection, which contains 1 request, is forked by selecting 'Fork Collection' from the collection menu. The forked collection is named "Pooja Mistry's fork" and is placed into the newly created workspace. The discussion highlights using Postman's Agent Mode (AI) to guide the process of setting up a Yelp Fusion Environment by creating an environment file containing necessary variables like yelpbaseurl and yelpapikey. The process successfully populates the environment variables in the new Yelp Fusion Env, ready for use with the forked collection, demonstrating how Agent Mode streamlines setup.

Context: The video features Pooja Mistry and Quinton Wall from Postman demonstrating a workflow for accelerating the creation of API demo projects. They focus on taking an existing, publicly available API collection from the Postman API Network (in this case, the Yelp Openings API) and forking it into a dedicated, private workspace for team experimentation and customization, utilizing Postman's AI Agent Mode to assist with environment setup.

Detailed Analysis

The session begins with Pooja and Quinton planning to build demo projects using various APIs, deciding to focus on the Yelp API for this demonstration. They navigate to the Postman API Network, search for and locate the public Notion API collection (though they quickly pivot to Yelp), and then search for the Yelp API documentation. After finding the Yelp Developer Portal, they identify the Yelp Reservations API as a target, but ultimately settle on the Yelp Openings API documentation. They then switch back to Postman, locate the public Yelp Openings API collection in the API Network, and fork it into a private workspace named "Notion Demo Project Template," which they created as an internal workspace and invited each other to as admins. After forking, they switch to Postman's Agent Mode in the new empty workspace and prompt the AI to create a Yelp Fusion Environment based on the Yelp API docs, which the AI successfully generates, populating it with necessary variables like yelpbaseurl and yelpapikey. This demonstrates how Agent Mode can significantly speed up the initial setup required to start experimenting with a forked collection.