note v2 API changes + full parameter list in README