added documentation for new rest methods