implement/fixes the rest services
add description for the REST services