rdoc comments updated to match new api response format