Hi - We have our APIs documented in Open API 3.0. I am able to import into postman and am looking to generate our documentation. At issue is documentation of our post/patch body data / schema. When I view the schema documentation online, that is what I would expect to see. All the fields in a post or patch under the “show properties”. Perfect. I don’t see though how to publish this documentation.
If I go to the collection (created when I import) I can see the ability to ability view and publish documentation but it is missing post / patch field definitions.
Can I get a complete set generated out of Postman?
Hey, I’m not sure what exactly you’re missing out on in your documentation. I could help you out if there were some screenshots. But one mistake I make is not saving my API’s when I’m done updating them which does not update the tags and the same show up on the documentation page.
Thanks for your reply but we are all set. A misunderstanding we had is we were continually importing the API from our Open API spec as we used another editor to update it as the source of truth.
With a little support help, Postman indicated they wanted to be the source of truth. So, now we are not blowing away any extra documentation we add. We just need to remember whenever we change the spec, export it from Postman and update our GIT repo.