Swagger

just to preview the changes needed to use swagger
True, but there's the potential for different responses from each method.  It sure would be nice to have defaults though.  500 is always going to be a server error, so that shouldn't have to be listed each time.  I think that's the point you're driving at?