Hide subfolder from documentation

I have a collection and I want to make a documentation out of it, but I need to hide 1 sub-folder from the documentation. Is this possible?

6 Likes

Hi @alzarka! Not at this time, no. Would you mind telling us a bit more about your use case so we can look into it as a possible future feature? In particular, all of our generated documentation has a ā€œRun in Postmanā€ button, so it would download with the sub-folder, even if the sub-folder was hidden in the UI (and the sub-folder would not be hidden in the app, so any sensitive information would be visible to them then). Is the collection meant to run for your audience (whoeverā€™s using it) with that sub-folder included? If not, I recommend duplicating the collection and removing the sub-folder from the duplicate, which you can then publish.

Yes, I could duplicate it and remove the sub-folder from duplicated and publish. But I am asked to do tests and documentation with the same one. Because if I duplicate it and later there will be any changes in our system then we will need to edit in original one and duplicate.

Hello, I have similar issue. I have request which return JSON. There is URL inside that JSON, I want to test that URL if response has code 200. I tried pm.sendRequest but itā€™s async. So Iā€™m thinking about creating another API request inside postman collection. But Itā€™s important to hide it in documentation, because it can confuse our customers when they are doing implementation of our API. So do you have some solution for it?

Same request here. I have a project that is in QA use with a 3rd party and I have new methods I am working on for enhancements to the service. I donā€™t want these methods visible to them at this time. It would be nice to be able to exclude them from the documentation without having to create a new project.

Would love to see this as well. I have a few requests that I use for handling errors in tests, which I donā€™t want seen in documentation. However, I have to copy-paste my whole collection, then remove the utility requests. Could be something as simple as hiding all folders with a leading ā€œ_ā€ (eg, a folder named ā€œ_utilitiesā€ would appear in all Postman clients, but would not be visible in the documentation)

Critical function for us. We need to hide admin functions from the public.

1 Like

It would be great!! we have some administration functions that shoud not be available for general users documentation

I can only support the arrival of this function ā€œhiddenā€, in the same case that many I have two file with functions that I would like to keep private or in phase of test but at the moment the only solution is duplicated.

Iā€™d also join - it would be a very useful feature. We have a few endpoints we donā€™t want to share with clients, but to create two version of docs and keep them manually in sync, just because of a few endpoints causes some overhead.

+1 bump
Iā€™d love the ability to set ā€œPrivateā€ on requests or folders so theyā€™re hidden from docs.

This is an important feature. for example:

  1. a collection for an API that is under development or under testing.
  2. a collection for a private API but I want one single location that contains everything.

This feature is really needed. Duplicating the collection and keeping tabs with both is not scalable.
Please make this feature a priority

this is one of the reasons why i will not invest any finances into postman. lacking of this major feature is just unacceptable.

Any update on thisā€¦ppl have mentioned lot of use case but no action taken yet??

Any update, @postman?
I also need this, just came to Postman but without this feature I wonā€™t be able to stay in it for my client :confused:

+1, Iā€™d also love to see this. I have a ā€œnegative testā€ folder to make sure errors are handled properly. Would not want this to be in the public documentation, but nice to keep it in the same collection. Just a folder of calls for internal use only.

The absence of this feature causes serious harm to companies that need to hide test and administrative collections mainly for the development environment.

Make quick implementation urgent.

We are a rising global company and we know what we are saying.

Any update guys? Maintaining duplicate Document is not scalableā€¦expecting some update soon

Ongoing issue in their github: Hide specific API's from Documentation. Ā· Issue #10384 Ā· postmanlabs/postman-app-support Ā· GitHub

1 Like