finished REST docs. fixes #241