README changes for the v1 API, some convenience methods.