Improve documentation for request and responses