postmanlabs
Hide specific API's from Documentation.
Is there an existing request for this feature?
- [X] I have searched the existing issues for this feature request
Is your feature request related to a problem?
We have a few endpoints that we don’t want to share with clients, it would be a very useful feature if we have an option to hide specific API to the documentation.
Describe the solution you'd like
Ability to set “Private” on requests or folders so they’re hidden from docs.
Describe alternatives you've considered
Create two versions of docs and keeping them manually in sync causes some overhead.
Additional context
We have a similar community thread: https://community.postman.com/t/hide-subfolder-from-documentation/1569/9
Will this be picked up? it's still an issue for me to not be able to toggle visibility for some endpoints with postman docs.
Would be possibly nice to add support for custom extensions for this kind of thing.
We are also in need of something similar, Stoplight for example supports the x-private flag for operations or entire APIs.
Hey, just ran into a need for this today. I assumed there would be a toggle to make certain endpoints private, but a quick google search led me here. Please add this functionality soon!
I assumed there would be a toggle to make certain endpoints private, but a quick google search led me here.
👍 Same here. Would be appreciated if this feature is coming soon.
Same here, we need to hide some endpoints in the docs:
- endpoints under development
- private/internal endpoints
Bump Would love to see this featuer implementation, i do not want to keep track of many different folders just to weed out endpoints that shouldnt be made aware to the public
Is this issue still being considered? We need to have a public and private version of our API and I don't wanna have to duplicate the documentation, as then we'd have to update the documentation for the public endpoints twice.
TBC, this is a highly needed feature, have some folders (backoffice and admin requests) that should not be included in the published documentation handed to clients.
I have a some private endpoints in my API that should only be known to the Admin. I need to keep it out of the public docs but still want it to be in the collection. This feature would really be helpful
This is something our team would also like to have, researched it today and found this post. It would be a very useful addition.
Quite happy to add this feature myself if I'm given access to the codebase @postman-staff
I would like to emphasize that this feature would be really appreciated! Not every function in our API should be opened to the public, but having only one project helps avoid duplications
+1 on this. We use postman both for internal development and external documentation. It is pain to maintain two documentation
I’m on board with this request! It’d be super helpful to hide specific endpoints from the documentation for better security
+1 here too! Seems there is plenty of demand for this feature and it makes sense that most have the same use case which is also not uncommon, moreover I would have expected that most developers would have need of this.
Its been more than 3 years and this most needed feature is still not completed
Its been more than 3 years and this most needed feature is still not completed
To be honest postman reeks of a project that has lost its original developer, or it's original developer has lost their mojo, and it's become something of a zombie. I stopped using and switched to Swagger a while ago.