updated api def