documents rest parameters