make API swagger compliant