generalize documentation; revert to body params