update docs to new api