restapiv3 batch of fixes to swagger doc