fixing doc issues and extending request HO api