updated api and README