updated response docs