Is there a way to conditionally show/hide api doc for some requests?

[anandagrawal84]

Is there a way to show/hide docs for certain endpoint/controller based on incoming request / auth? I can put a middle ware to disallow access to the deeplink of the protected resource '*/protected_resource/index.html' but cant find a way to hide from main doc page.

[zarelit]

There is the possibility to hide the documentation (unconditionally), but it would be nice to have docs that only a subset of users are allowed to see.
A couple of use cases are:

• private endpoints (e.g. public endpoints for users, private endpoints to registered developers)
• showing documentation of endpoints that are not released only to testers