How to import and export Postman collections, and what are Postman workspaces?

Exporting a Collection

1. ✓Click on your Collection in the sidebar
2. ✓Click the ... (three dots) menu
3. ✓Select Export
4. ✓Choose Collection v2.1 (recommended) or v2.0
5. ✓Click Export and save the JSON file

The exported file (MyCollection.json) can be:

• ✓Committed to Git for version control
• ✓Shared via email/Slack
• ✓Used with Newman for CI/CD

Importing a Collection

Method 1: Drag and Drop Simply drag the .json file into the Postman window.

1. ✓Click Import (top left)
2. ✓Choose: File, Folder, Link, Raw text, or Code
3. ✓Select your file → Click Import

Import → Link → https://raw.githubusercontent.com/org/repo/main/collection.json

1. ✓Import → Code Repository → Connect GitHub
2. ✓Select your repository and collection file

Import Environment

// staging-environment.json
{
  "name": "Staging",
  "values": [
    { "key": "base_url", "value": "https://api.staging.com", "enabled": true },
    { "key": "api_token", "value": "staging-token-xyz", "enabled": true }
  ]
}

A Workspace is a collaborative environment where you organize and share collections, environments, and APIs with your team.

Types of Workspaces

Creating a Workspace

1. ✓Click Workspaces (top menu)
2. ✓Click Create Workspace
3. ✓Choose type: Personal / Team / Private / Public
4. ✓Add team members (for Team/Private)
5. ✓Move collections into the workspace

Benefits of Team Workspaces

• ✓Everyone sees the same collections without exporting/importing
• ✓Changes are synced in real-time
• ✓Share environments (staging, prod configs)
• ✓Activity feed — see who changed what and when
• ✓Role-based access — admin, editor, viewer

Workspace Best Practices

📁 Team Workspace: "User Service API"
  ├── 📂 Collections
  │   ├── User API Tests
  │   ├── Auth API Tests
  │   └── Regression Suite
  ├── 🌍 Environments
  │   ├── Development
  │   ├── Staging
  │   └── Production
  └── 📋 APIs
      └── User Service OpenAPI Spec