some corrections on the swagger api