updated documentation for responses