readme: updated api