updated docs for new api