updated rest api documentation