improve success and error responses in apidocs