FInal docs for entities API