updated api doc for event scoring