[#70587174] reordering api docs and adding detail to authentication