It would also be helpful if you mentioned the dependence on `requests.Session` and point to that API doc rather.
Also, API docs guys? (out of scope of this monster of a PR)