replace README with new API