# Postman

> Postman API platform for testing and documentation. Use for API testing. Use when this capability is needed.

- Skill: `tomevault-io/postman` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/postman`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/postman/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/postman

---


# Postman

Postman is the complete API lifecycle platform. 2025 features **AI Agent Builder** (orchestrating multi-step workflows) and **Postbot** (AI driven testing).

## When to Use

- **API Development**: Documentation, Mock Servers, and Monitors.
- **Testing**: Automated testing in CI via `newman` CLI.
- **Collaboration**: Workspaces and "Forks" of collections.

## Core Concepts

### Collections

Groups of requests. Can be run as a suite.

### Environments

Variables (`{{base_url}}`) that change between Dev, Staging, and Prod.

### Pre-request Scripts

JavaScript code that runs before a request (e.g. generating an HMAC signature).

## Best Practices (2025)

**Do**:

- **Use AI Agents**: Build workflows that chain requests intelligently using natural language.
- **Use Mock Servers**: Design the API first, create a mock, and let frontend devs build against it before backend is ready.
- **Use `newman`**: Run collections in GitHub Actions.

**Don't**:

- **Don't hardcode auth**: Use "Auth" tab variables.

## References

- [Postman Documentation](https://learning.postman.com/docs/introduction/overview/)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/g1joshi) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->