This documentation is for WSO2 API Manager 1.5.0 View documentation for the latest release.
Page Comparison - Adding Documentation Using API Publisher (v.4 vs v.5) - API Manager 1.5.0 - WSO2 Documentation

Versions Compared


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


  1. Log in to WSO2 API Publisher with a user who has been assigned the creator role. For more information on creating users and assigning roles, refer to section User Management.
  2. The currently available APIs appear on the All APIs window. Select the API to which you want to add documentation to. For example,
  3. Select the Docs tab of the API and click the Add New Document link.
  4. Add the following information to create a document for the API.
    1. Name: Name of the document. This is mandatory.
    2. Summary: A short description of the document which will appear in the API store.
    3. Type: There are several document types available as follows. If required, a new type can also be introduced.
      • How To
      • Samples and SDK
      • Public forum / Support forum ( external link only)
      • API message formats
      • Other
    4. Source: Whether the document is stored inline or provided via a URL.
      • In-line: Documentation hosted in the API Manager itself. For inline documentation, you can edit the contents directly from the API publisher interface.
      • URL: If you already have comprehensive documentation managed by an external configuration management system, you can simply link to those file references (URLs) through the API Manager rather than importing them to the server.

      Click the Add Document button to complete.
  5. The added document shows on the same window. Click the Edit Content link associated with it.
  6. The embedded editor opens allowing you to edit the document content.


  1. Image Added

All documents have unique URLs to help improve SEO support. After editing the API, publish it for it to be available to external parties through the API Store. For instructions on publishing an API, refer to section Managing an API Life Cycle.