Swagger spec needs revision

[sheridancbio]

Some output types are not in sync with the true return types. Also some global meta information of the api (such as version, ...) needs to be set in order to avoid display of an error icon.