updated entity api