api docs updates