update docs with new api methods