refactor modifications to swagger 2.0 schema