FAIMS-530: updating api docs