updating README per new APIs