# \#openapi **URL:** https://community.postman.com/tag/openapi/148.md [Latest](https://community.postman.com/latest.md) · [Categories](https://community.postman.com/categories.md) · [Tags](https://community.postman.com/tags.md) --- ## [Announcing reShapr](https://community.postman.com/t/announcing-reshapr/89679)
**Author:** [@pooja-mistry](https://community.postman.com/u/pooja-mistry)\ **Replies:** 0\ **Last updated:** [April 1, 2026, 10:47am UTC](https://community.postman.com/t/announcing-reshapr/89679 "2026-04-01T10:47:05Z")
Agents rely on APIs for real-time data and context, but turning those APIs into something AI agents can use is often where the friction starts. Today, we’re announcing reShapr, a new open-source project that helps teams… --- ## [Automatically sync OpenAPI/Swagger spec to collection](https://community.postman.com/t/automatically-sync-openapi-swagger-spec-to-collection/8551)
**Author:** [@obasekia](https://community.postman.com/u/obasekia)\ **Replies:** 24\ **Last updated:** [November 14, 2025, 12:47pm UTC](https://community.postman.com/t/automatically-sync-openapi-swagger-spec-to-collection/8551 "2025-11-14T12:47:16Z")
Hello, I’ve recently started exploring the use of Swagger documentation with our teams that currently use Postman for API test automation. The ability to import a spec and have it created as a collection in postman is g… --- ## [Postman Collection Export Limitations (Loss of parameter's additional properties and body schemas)](https://community.postman.com/t/postman-collection-export-limitations-loss-of-parameters-additional-properties-and-body-schemas/83533)
**Author:** [@devdeer-andrii](https://community.postman.com/u/devdeer-andrii)\ **Replies:** 1\ **Last updated:** [August 13, 2025, 2:39pm UTC](https://community.postman.com/t/postman-collection-export-limitations-loss-of-parameters-additional-properties-and-body-schemas/83533 "2025-08-13T14:39:37Z")
Overview Recently I started importing collections using OpenAPI JSON-files. Of course this gives all advantages of having parameter types in requests, JSON-body’s verification and so on. Below are some examples: … --- ## [New in Postman: Sync Your Specs, Without the Switch](https://community.postman.com/t/new-in-postman-sync-your-specs-without-the-switch/79352)
**Author:** [@gbadebo-bello](https://community.postman.com/u/gbadebo-bello)\ **Replies:** 3\ **Last updated:** [May 5, 2025, 12:26pm UTC](https://community.postman.com/t/new-in-postman-sync-your-specs-without-the-switch/79352 "2025-05-05T12:26:15Z")
TL;DR Spec Hub helps you centralize, manage, collaborate on, and build high-quality API specifications(OpenAPI, AsyncAPI, and more), without context switching. One place to rule them all! Why this matters With Spec Hu… --- ## [Importing OAS contract - Parameter examples not loaded](https://community.postman.com/t/importing-oas-contract-parameter-examples-not-loaded/79394)
**Author:** [@syscents](https://community.postman.com/u/syscents)\ **Replies:** 2\ **Last updated:** [May 2, 2025, 12:36pm UTC](https://community.postman.com/t/importing-oas-contract-parameter-examples-not-loaded/79394 "2025-05-02T12:36:39Z")
Hello, I want to create a Postman collection from an API contract. I need Postman creates samples based on the contract. However, I’m unable to get Postman to load the parameter values (headers in this case) according… --- ## [Importing openapi3 with path variable](https://community.postman.com/t/importing-openapi3-with-path-variable/45427)
**Author:** [@navigation-meteorolo](https://community.postman.com/u/navigation-meteorolo)\ **Replies:** 2\ **Last updated:** [May 1, 2025, 8:33am UTC](https://community.postman.com/t/importing-openapi3-with-path-variable/45427 "2025-05-01T08:33:26Z")
The current way that postman imports openapi into :variable notation means that a path variable cannot be set at an environment level. So for example, this valid spec that requires an orgId in the path for every request … --- ## [Postman and Swagger 2.0 compatibility issue](https://community.postman.com/t/postman-and-swagger-2-0-compatibility-issue/47788)
**Author:** [@sreekanth.mondeli](https://community.postman.com/u/sreekanth.mondeli)\ **Replies:** 0\ **Last updated:** [May 24, 2023, 7:27pm UTC](https://community.postman.com/t/postman-and-swagger-2-0-compatibility-issue/47788 "2023-05-24T19:27:45Z")
Hi Team, I have encountered a situation, where if I specify any members other than “$ref” under schema, the postman will catch it as a syntactical error where as the specification says “Any members other than “$ref” in… --- ## [API Schema doesn't get update using Postman API](https://community.postman.com/t/api-schema-doesnt-get-update-using-postman-api/24799)
**Author:** [@thefierycoder](https://community.postman.com/u/thefierycoder)\ **Replies:** 0\ **Last updated:** [June 12, 2021, 6:15am UTC](https://community.postman.com/t/api-schema-doesnt-get-update-using-postman-api/24799 "2021-06-12T06:15:00Z")
Hello there, I’m trying to add a default response to each path of the API schema but whenever I tried to update it, it doesn’t get updated, it only shows a 200 response. but in the console it shows an updated schema… --- ## [Enhance Your API Standards Using Spectral and Postman](https://community.postman.com/t/enhance-your-api-standards-using-spectral-and-postman/76858)
**Author:** [@david-espi-hernandez](https://community.postman.com/u/david-espi-hernandez)\ **Replies:** 0\ **Last updated:** [March 31, 2025, 2:59pm UTC](https://community.postman.com/t/enhance-your-api-standards-using-spectral-and-postman/76858 "2025-03-31T14:59:00Z")
The ​​Postman Collection is a fantastic tool for collaborating with your team throughout the API design, development, testing, and documentation stages. But that’s not all—Postman’s API builder also lets you create and m… --- ## [Creating an OpenAPI definition from a collection with the Postman API](https://community.postman.com/t/creating-an-openapi-definition-from-a-collection-with-the-postman-api/73416)
**Author:** [@david-espi-hernandez](https://community.postman.com/u/david-espi-hernandez)\ **Replies:** 5\ **Last updated:** [January 29, 2025, 10:28am UTC](https://community.postman.com/t/creating-an-openapi-definition-from-a-collection-with-the-postman-api/73416 "2025-01-29T10:28:43Z")
Postman’s integrated API Builder lets you design your APIs with an API definition. But even with the help of the API Builder, creating an OpenAPI specification can be difficult. On the other hand, it’s easier to create c… --- ## [Convert OpenAPI3 examples to postman examples](https://community.postman.com/t/convert-openapi3-examples-to-postman-examples/50012)
**Author:** [@joint-operations-ca1](https://community.postman.com/u/joint-operations-ca1)\ **Replies:** 6\ **Last updated:** [January 29, 2025, 10:09am UTC](https://community.postman.com/t/convert-openapi3-examples-to-postman-examples/50012 "2025-01-29T10:09:17Z")
How can i convert OpenAPI examples to Postman Collection examples? In OpenAPI 3, we can define different named examples for parameters, request bodies and responses, for instance "/test-resources/{TYPE}": { … --- ## [Integration Research: Security, Gateway, CI/CD, API Discovery & more](https://community.postman.com/t/integration-research-security-gateway-ci-cd-api-discovery-more/73864)
**Author:** [@flight-technologist6](https://community.postman.com/u/flight-technologist6)\ **Replies:** 0\ **Last updated:** [January 15, 2025, 8:48pm UTC](https://community.postman.com/t/integration-research-security-gateway-ci-cd-api-discovery-more/73864 "2025-01-15T20:48:33Z")
Hello Postman users! I work on Ecosystem at Postman and want to hear all about your integration hopes and dreams! As we think about opening up our platform to enable more integration opportunities, I want to learn how … --- ## [Generating Collection from OpenAPI with Tags](https://community.postman.com/t/generating-collection-from-openapi-with-tags/45148)
**Author:** [@mrabetr](https://community.postman.com/u/mrabetr)\ **Replies:** 2\ **Last updated:** [December 12, 2024, 2:35pm UTC](https://community.postman.com/t/generating-collection-from-openapi-with-tags/45148 "2024-12-12T14:35:42Z")
I have an OpenAPI schema which groups requests by tags. I used to be able to generate a collection from the API definition which then places each request in a folder named according to the tag it belongs to. In the most… --- ## [Documentation from API definition](https://community.postman.com/t/documentation-from-api-definition/69127)
**Author:** [@iegghilba](https://community.postman.com/u/iegghilba)\ **Replies:** 0\ **Last updated:** [October 1, 2024, 1:01pm UTC](https://community.postman.com/t/documentation-from-api-definition/69127 "2024-10-01T13:01:07Z")
Hi all, I started an API project writing OpenAPI code on the Postman Desktop app. Despite the absence of synthax errors I do not see the live preview in the right pane (I have no ‘documentation’ icon on right sidebar). … --- ## [Api definition not updated after pull commits change the OpenAPI](https://community.postman.com/t/api-definition-not-updated-after-pull-commits-change-the-openapi/62497)
**Author:** [@jdelpierre](https://community.postman.com/u/jdelpierre)\ **Replies:** 0\ **Last updated:** [June 21, 2024, 1:39pm UTC](https://community.postman.com/t/api-definition-not-updated-after-pull-commits-change-the-openapi/62497 "2024-06-21T13:39:03Z")
Version 11.2.13 Hello, I have a new project in progress and I’m starting to use the connection to Github repos. I can load my OpenAPI in the “APIs” tab, my YAML is root. In the meantime, the developer has updated thi… --- ## [Update a collection with an open API spec file using the Postman API?](https://community.postman.com/t/update-a-collection-with-an-open-api-spec-file-using-the-postman-api/18321)
**Author:** [@joint-operations-eng](https://community.postman.com/u/joint-operations-eng)\ **Replies:** 3\ **Last updated:** [April 12, 2024, 7:41am UTC](https://community.postman.com/t/update-a-collection-with-an-open-api-spec-file-using-the-postman-api/18321 "2024-04-12T07:41:03Z")
Hey, I’m evaluating postman as a solution for our API docs and I’ve been using the import external API specification endpoint to import an open api spec. This creates the collection on the first import and works fine (a… --- ## [Import API best practice in manual tests](https://community.postman.com/t/import-api-best-practice-in-manual-tests/59837)
**Author:** [@aleksanderkoprivnjak](https://community.postman.com/u/aleksanderkoprivnjak)\ **Replies:** 0\ **Last updated:** [April 11, 2024, 9:32am UTC](https://community.postman.com/t/import-api-best-practice-in-manual-tests/59837 "2024-04-11T09:32:02Z")
Hello! I’ll try to elaborate what my problem is. We have a lot of APIs that our devs are working on. For my tests I import the API once and after that all changes, updates, and so on, are added manually to the collecti… --- ## [Automatic importing of collections with Postman API](https://community.postman.com/t/automatic-importing-of-collections-with-postman-api/58263)
**Author:** [@jthom2](https://community.postman.com/u/jthom2)\ **Replies:** 4\ **Last updated:** [March 1, 2024, 3:53pm UTC](https://community.postman.com/t/automatic-importing-of-collections-with-postman-api/58263 "2024-03-01T15:53:37Z")
Im trying to create a script using the Postman API to import a URL as a collection. When I use the import button through the app, it works, but doing with the script returns that it is missing a required parameter “colle… --- ## ["Unable to validate this definition" when choosing 3.1.0](https://community.postman.com/t/unable-to-validate-this-definition-when-choosing-3-1-0/56871)
**Author:** [@maintenance-pilot-92](https://community.postman.com/u/maintenance-pilot-92)\ **Replies:** 1\ **Last updated:** [January 25, 2024, 11:38am UTC](https://community.postman.com/t/unable-to-validate-this-definition-when-choosing-3-1-0/56871 "2024-01-25T11:38:30Z")
If I create a new API from boilerplate, it creates it with "openapi": "3.1.0", and looks fine. But when I change my version in my existing API index.json from 3.0.3 to 3.1.0, I get an “Unable to validate the definition… --- ## [Direct link to API documentation](https://community.postman.com/t/direct-link-to-api-documentation/55970)
**Author:** [@spacecraft-speciali1](https://community.postman.com/u/spacecraft-speciali1)\ **Replies:** 3\ **Last updated:** [December 27, 2023, 2:26pm UTC](https://community.postman.com/t/direct-link-to-api-documentation/55970 "2023-12-27T14:26:26Z")
I imported openapi, now I have an API which I have published a version of. How can I get a direct link to the documentation of this API on documenter.getpostman.com with version switching, as was previously the case for … --- ## [OpenAPI Definition file from server not updating](https://community.postman.com/t/openapi-definition-file-from-server-not-updating/55203)
**Author:** [@sjansenxaurum](https://community.postman.com/u/sjansenxaurum)\ **Replies:** 3\ **Last updated:** [December 4, 2023, 10:59am UTC](https://community.postman.com/t/openapi-definition-file-from-server-not-updating/55203 "2023-12-04T10:59:50Z")
When my server has a change in its api definition file (swagger.json) it’s not picked up by postman. The collection update only happens when I manually remove the definition and add it back. Seems that the file from ser… --- ## [How to get a url to my api definition?](https://community.postman.com/t/how-to-get-a-url-to-my-api-definition/54387)
**Author:** [@carematemichael](https://community.postman.com/u/carematemichael)\ **Replies:** 2\ **Last updated:** [November 7, 2023, 4:38pm UTC](https://community.postman.com/t/how-to-get-a-url-to-my-api-definition/54387 "2023-11-07T16:38:23Z")
noob here, can I get a link that points to an api definition (yaml file) in postman? --- ## [How to create mock server from OpenAPI spec? (CDD)](https://community.postman.com/t/how-to-create-mock-server-from-openapi-spec-cdd/53434)
**Author:** [@dominikpsoll](https://community.postman.com/u/dominikpsoll)\ **Replies:** 1\ **Last updated:** [November 2, 2023, 4:57pm UTC](https://community.postman.com/t/how-to-create-mock-server-from-openapi-spec-cdd/53434 "2023-11-02T16:57:31Z")
TLDR: Im able to import OpenAPI spec as API in Postman. Im able to generate mock server from collections. But i dont see a way to connect these two - create mock server from API spec like for example in SoapUI, ReadyAP… --- ## [Using multiple files like a data dictionary](https://community.postman.com/t/using-multiple-files-like-a-data-dictionary/53144)
**Author:** [@accipiternisus8888](https://community.postman.com/u/accipiternisus8888)\ **Replies:** 0\ **Last updated:** [October 11, 2023, 4:13pm UTC](https://community.postman.com/t/using-multiple-files-like-a-data-dictionary/53144 "2023-10-11T16:13:00Z")
Hi. Can Postman be configured to have like a yaml / json file in Github say (lets refer to that as a global data dictionary), that contains all your field names and their attributes or complex structures (referencing fi… --- ## [Array in requestBody duplicates array indexes](https://community.postman.com/t/array-in-requestbody-duplicates-array-indexes/51019)
**Author:** [@rjs](https://community.postman.com/u/rjs)\ **Replies:** 0\ **Last updated:** [August 27, 2023, 2:25pm UTC](https://community.postman.com/t/array-in-requestbody-duplicates-array-indexes/51019 "2023-08-27T14:25:54Z")
Hi all, After creating a new API in PM (see JSON code) and Add Collection → Generate from definition the requestBody duplicates the proparray indexes and deleted array is not printed. When importing same file to Swagge… --- ## [Is it possible to create a collection from an OpenAPI document OAS 2.0 or OAS 3.0?](https://community.postman.com/t/is-it-possible-to-create-a-collection-from-an-openapi-document-oas-2-0-or-oas-3-0/50621)
**Author:** [@skyeye](https://community.postman.com/u/skyeye)\ **Replies:** 1\ **Last updated:** [August 17, 2023, 9:31pm UTC](https://community.postman.com/t/is-it-possible-to-create-a-collection-from-an-openapi-document-oas-2-0-or-oas-3-0/50621 "2023-08-17T21:31:23Z")
I’ve got an Open API (OAS) document (in YAML but I’ve tried the one in JSON too) that describes some APIs exposed by a server. From my workspace, choosing “Import”, I have 2 options: “Postman collection” or “OpenAPI 2.0… --- ## [Unable to import API definition from Swagger docs](https://community.postman.com/t/unable-to-import-api-definition-from-swagger-docs/50152)
**Author:** [@cindi-qa](https://community.postman.com/u/cindi-qa)\ **Replies:** 2\ **Last updated:** [August 2, 2023, 11:30am UTC](https://community.postman.com/t/unable-to-import-api-definition-from-swagger-docs/50152 "2023-08-02T11:30:30Z")
My question: Was ungraded to 10.16.4 on July 25 and now I am unable to import my API definitions from Swagger as the option is greyed out when I enter in the URL needed to access the information. Details (like screensh… --- ## [OpenAPI 3.1.0 import values not taken from examples given in the spec](https://community.postman.com/t/openapi-3-1-0-import-values-not-taken-from-examples-given-in-the-spec/49420)
**Author:** [@MaxT](https://community.postman.com/u/MaxT)\ **Replies:** 3\ **Last updated:** [July 26, 2023, 12:04pm UTC](https://community.postman.com/t/openapi-3-1-0-import-values-not-taken-from-examples-given-in-the-spec/49420 "2023-07-26T12:04:57Z")
My question: I’m importing an openapi 3.1.0 schema into my workspace, and every value set by default is wrong. It’s always following this pattern: (eg: , ) while my openapi document contains examples for each attribute… --- ## [OpenApi import with multi-file support](https://community.postman.com/t/openapi-import-with-multi-file-support/9439)
**Author:** [@luca.rospocher](https://community.postman.com/u/luca.rospocher)\ **Replies:** 11\ **Last updated:** [July 17, 2023, 12:32pm UTC](https://community.postman.com/t/openapi-import-with-multi-file-support/9439 "2023-07-17T12:32:41Z")
Hello, I’m am trying to import in Postman an API in OpenApi v3 format. I can do that with a single file and then generate a collection, but i cannot import a folder containing various yaml/json files. In post https://b… --- ## [When importing OpenApi spec in postman Optional parameters are by default enabled](https://community.postman.com/t/when-importing-openapi-spec-in-postman-optional-parameters-are-by-default-enabled/49526)
**Author:** [@telecoms-technolog10](https://community.postman.com/u/telecoms-technolog10)\ **Replies:** 0\ **Last updated:** [July 13, 2023, 2:39pm UTC](https://community.postman.com/t/when-importing-openapi-spec-in-postman-optional-parameters-are-by-default-enabled/49526 "2023-07-13T14:39:57Z")
My question: I imported an OpenAPI spec via the postman directly and in that collection, all header parameters are by default enabled. In the OpenAPI spec, I have clearly defined that the relevant parameters are optiona… [Next page](https://community.postman.com/tag/openapi/148.md?match_all_tags=true&page=1&tags%5B%5D=openapi)