postman-collection-generator

Generate Postman v2.1 collections from FastAPI router files.

11|3|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/tonehq/tone --skill postman-collection-generator-tonehq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postman-collection-generator
Source: https://github.com/tonehq/tone/tree/main/.claude/skills/postman
Command: npx skills add https://github.com/tonehq/tone --skill postman-collection-generator-tonehq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate and maintain Postman v2.1 collections by reading FastAPI router files, enabling seamless API documentation, testing, and collaboration.

Core Features & Use Cases

  • Generate one Postman collection per controller (router file) from FastAPI routes.
  • Handle Core and EE editions with a single collection, prefixing EE endpoints when present.
  • Export, sync, and update API changes to Postman collections to keep docs in sync with code.

Quick Start

Run the tool with a FastAPI router path and an output directory to generate Postman collections for each controller.

Frequently Asked Questions about postman-collection-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Postman collection from FastAPI routes?

To generate a Postman collection from FastAPI routes, you run the generator with a specific router file path and an output directory. It discovers endpoints, methods, and prefixes to output a v2.1 collection per controller.

Can I generate Postman documentation for both Core and EE FastAPI editions in a single collection?

Yes, you can generate Postman documentation for both Core and EE FastAPI editions in a single collection. The tool automatically prefixes EE endpoints when present, keeping all API documentation synchronized in one place.

What is the best way to keep Postman collections in sync with FastAPI code changes?

The best way to keep Postman collections in sync with FastAPI code changes is to automate generation from router files. By exporting and updating directly from routes, your API documentation remains accurate without manual updates.

Does Postman collection generation from FastAPI include example requests and responses?

Yes, Postman collection generation from FastAPI includes example requests and responses. The tool composes accurate API collections by reading router files and automatically embedding examples for seamless testing and collaboration.

How are FastAPI router prefixes handled when exporting to Postman collections?

When exporting to Postman collections, FastAPI router prefixes are discovered and applied accurately to the generated endpoints. This ensures the v2.1 collection reflects the exact routing structure defined in your code.