improve rest endpoint doc
improve rest endpoint doc

nicolaasmatthijs/Hilary,Orodan/Hilary,stuartf/Hilary,ExC0d3/Hilary,timdegroote/Hilary,mrvisser/Hilary,ExC0d3/Hilary,Coenego/Hilary,jfederico/Hilary,timdegroote/Hilary,Orodan/Hilary,nicolaasmatthijs/Hilary,simong/Hilary,jfederico/Hilary,mrvisser/Hilary,simong/Hilary,stuartf/Hilary