From Postman Collections to API Docs

Use Postman collections in workflows. OpenAPI is the industry standard for APIs. Here’s how to turn your Postman collections into nice API docs.

Step 1: Get OpenAPI from Postman

1curl --location --request GET 'https://api.getpostman.com/collections/9000792-baf934a6-d53d-4fe8-8732-d512f955f686'/transformations \
2--header 'X-Api-Key: PMAK-660bb9d70491ad0001d1f7ab-587f4f4769983f197ebcf6450acbfee7fb' | jq '.output | fromjson' > GoogleAdsOpenAPI.json

This converts your Postman collection to OpenAPI format. Replace the collection ID and API key with yours.

Step 2: Build docs

1npx @redocly/cli build-docs GoogleAdsOpenAPI.json --output=google-ads-api.html

This creates clean HTML documentation from your OpenAPI file.

Step 3: Profit

Type-safe APIs

For TypeScript clients: OpenAPI Stack

Tags

#open-api #postman-collections #swagger #redocly #api-documentation #workflow