Update API docs to reflect new request state update methods

Docs pull request as a result of #1631