updates to services api docs