Request for new feature to mark API Internal/External

[ronirajan-fd]

Is there any way we can mark some APIs internal external with OpenAPI extensions that can be used by Developer studio team to decide if they should show this in client facing env. or not? is something similar already available?

Our team is adding below tag in hope we can use to differentiate.
x-api-scope: Internal

See comments on OpenAPI spec request. They believe this is something can be used done with extensions and the responsibility taken on the devleoper portal implementation to show/hide or control access.
OAI/OpenAPI-Specification#433

[github-actions]

Congratulations for opening your first issue!

[adamaltman]

@ronirajan-fd this isn't part of the spec currently, and it's not clear that it should be. There are solutions in the market that solve this using specification extensions -- more or less like your x-api-scope: internal.

See this for an example of one: https://redocly.com/docs/cli/guides/hide-apis/

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.