updated request documentation