clarified request and response specs