added explicit docstrings to request fns