api docs corrections