rest api documentation changes for consistency