Hide subfolder from documentation

🙋 Help
,
1

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?

7 Likes
2

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.

3

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.

4

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?

5

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.

6

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)

7

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

1 Like
8

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

9

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.

10

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.

11

+1 bump
I’d love the ability to set “Private” on requests or folders so they’re hidden from docs.

12

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.
13

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

14

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

15

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

16

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:

17

+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.

18

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.

19

Any update guys? Maintaining duplicate Document is not scalable…expecting some update soon

20

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

1 Like