Folder hierarchy in Postman

Introduction

Folder hierarchy helps organize your API requests in Postman. It makes your tests neat and easy to find.

You have many API requests and want to group them by feature or module.

You want to run tests for a specific group of related API requests.

You need to share organized API collections with your team.

You want to keep your workspace clean and easy to navigate.

Syntax

Postman

Collection > Folder > Request

A Collection is the top-level container for your API tests.

Folders inside Collections group related requests together.

Examples

This shows a collection with two folders, each containing related API requests.

Postman

My API Collection
  ├─ User Management Folder
  │    ├─ Create User Request
  │    └─ Delete User Request
  └─ Product Management Folder
       ├─ List Products Request
       └─ Add Product Request

Organizing requests by feature helps you run and manage tests easily.

Postman

Collection: Shopping App
  Folder: Cart APIs
    Request: Add to Cart
    Request: Remove from Cart
  Folder: Order APIs
    Request: Place Order
    Request: Cancel Order

Sample Program

This example shows how to organize API requests in folders inside a collection for better management.

Postman

1. Open Postman.
2. Create a new Collection named "Library API".
3. Inside the Collection, create a Folder named "Books".
4. Add requests like "Get Book List" and "Add New Book" inside the "Books" folder.
5. Create another Folder named "Authors" with requests like "Get Author Info".
6. Run tests on the "Books" folder to check book-related APIs.

Important Notes

Use clear and descriptive folder names to find requests easily.

You can nest folders inside other folders for deeper organization.

Folders help you run a group of requests together as a batch.

Summary

Folder hierarchy organizes API requests inside collections.

It helps manage and run related tests easily.

Use folders to keep your workspace clean and understandable.