using the correct swagger annotations and application/xml disabled due to problems with /capabilities
using the correct swagger annotations and application/xml disabled due to problems with /capabilities