updated entity API