Open Agent Mode
Agent Mode is an AI assistant built into Postman that completes API development tasks from natural-language prompts — creating workspaces and collections, writing tests, debugging errors, and more. It asks clarifying questions before taking action, and shows you what it's about to do before running it.
- Open Postman (desktop app or web).
- You can open Agent Mode two ways:
- From the homepage: type a request into the query box and click Let's go — this opens your most recent workspace with Agent Mode loaded.
- From any workspace: open the panel in the bottom-right corner and switch to the AI tab.
- Try typing
@in the Agent Mode input — this lets you point Agent Mode at a specific collection, folder, request, environment, or API spec as context for your prompt. You'll use this in later steps.
Learn more: Agent Mode overview
Create Your Workspace with a Prompt
Instead of clicking through the Create Workspace dialog yourself, describe what you want and let Agent Mode do it.
-
In Agent Mode, write a prompt like:
Create a new Internal workspace called "[Your Name] - AI Basics" that only I can access.
-
Replace
[Your Name]with your actual name (e.g. Alex - AI Basics). -
Review what Agent Mode proposes, then approve it.
Build a Collection from the Movies API
Now that you have a workspace, let Agent Mode do the tedious part — describing an entire API in plain English and letting it scaffold every request for you, instead of building each one by hand.
The Movies API is a free, publicly hosted REST API with no authentication:
| Method | Endpoint | Description |
|---|---|---|
| GET | /movies/animation | List all animated movies |
| GET | /movies/animation/:id | Get one movie |
| POST | /movies/animation | Create a movie |
| PUT | /movies/animation/:id | Update a movie |
| DELETE | /movies/animation/:id | Delete a movie |
A movie has an id (number, required), title (string, required), posterURL (string, required), and imdbId (string, required).
-
Make sure you're in your [Your Name] - AI Basics workspace from Step 2.
-
In Agent Mode, write a prompt like:
Create a collection called "Movies API" in this workspace. Add a request for each of these endpoints: GET /movies/animation, GET /movies/animation/:id, POST /movies/animation, PUT /movies/animation/:id, DELETE /movies/animation/:id. Use https://api.sampleapis.com as the base URL. For POST and PUT, include an example JSON body with id, title, posterURL, and imdbId.
-
Review the requests Agent Mode creates, then approve it.