entity api updates