IBM Watson™ Ideas

Welcome to the IBM Watson™ Ideas Portal


We welcome and appreciate your feedback on IBM Watson™ Products to help make them even better than they are today!


If you are looking for troubleshooting help or wondering how to use our products and services, please check the IBM Watson™ documentation. Please do not use the Ideas Portal for reporting bugs - we ask that you report bugs or issues with the product by contacting IBM support.


Before you submit an idea, please perform a search first as a similar idea may have already been reported in the portal.


If a related idea is not yet listed, please create a new idea and include with it a description which includes expected behavior as well as why having this feature would improve the service and how it would address your use case.

provide file-based swagger specification of API for use in API management solutions

Using Watson Assistand/Conversation Service with IBM API Connect (and other API Management solutions)  there is a strong need for a swagger specification of the WCS API in file format describing the API calls and its in- and output of the currently provided service.
This file-based specification (e.g. json, yaml) can be used for importing into API Connect for managing and controlling the client use of those APIs. For security reasons the API responses for WCS requests need to be validated against the provided schemas.
 
As the WCS service does change and enhance over time, every time a new service releases is provided the appropriate swagger specification for the APIs is needed again to continue the validation of the new response payload.
 
IBM would need to provide such a file-based specification for each new API version which is provided. A documentation is available but not sufficient for this case.
  • Guest
  • Apr 9 2018
  • Shipped
  • Attach files
  • Detlef Kleinfelder commented
    April 09, 2018 12:58

     This is an external version of idea ASSISTANT-I-57 for allowing clents to vote as well.

  • Admin
    Mitch Mason commented
    07 Jan 20:40

    at the top of the api reference you can download the open api definition

    https://console.bluemix.net/apidocs/assistant