added comments for REST functions