This documentation is for WSO2 API Manager 1.9.0. View documentation for the latest release.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


API visibility and subscription

API visibility

Visibility settings prevent certain user roles from viewing and modifying APIs created by another user role.

  • Public: The API is visible to all users (registered and anonymous), and can be advertised in multiple stores (central and non-WSO2 stores).
  • Restricted by Roles: The API is visible to it's tenant domain and only to the user roles that you specify.

  • Visible to my domain: The API is visible to all users who are registered to the API's tenant domain. This option is available only in a multi-tenanted environment. It's not applicable when there is only one active tenant in the system.


  • API creator and publisher roles can see all APIs in their tenant store even if you restrict access to them. This is because those roles have permission to view and edit all APIs in the API Publisher, and therefore, does not have to be restricted in the Store.
  • Anonymous users can only see APIs that have visibility as Public.
  • Registered users can see 
    • public APIs of all tenant domains  
    • all APIs in the registered user's tenant domain as long as the API is not restricted to a role that the user is assigned to

Subscription availability

You can set the Subscription the Subscription availability option , which you can set through the UI. In the following instances, the subscription availability option is not available:


to an API through the API Publisher's Manage tab. However, this option is not available in the following instances:

  • When there is only one tenant in your systemYou selected the . It is applicable only in a multi-tenanted setup.
  • Even if there are multiple tenants in your system, when you selected Visible to my domain as the API's visibility in a multi-tenanted setupthe previous step

The subscription availability option has three values as follows:

  • Available to current Tenant Only: only users in the current organization/tenant domain can subscribe to the API 
  • Available to All the Tenants: users of all organizations/tenant domains can subscribe to the API 
  • Available to Specific Tenants: users of the organizations/tenant domains you specify as well as the current tenant domain can subscribe to the API


The diagram below depicts this relationshipthe relationship between the API's visibility and subscription availability:



API documentation visibility