- updating docs for new api in interation.py