Clean up API docs a little bit
Include more useful information in errors
Updates to success and error response formats