Update API docs to reflect new request state update methods

Docs pull request as a result of #1631 

<!---
@huboard:{"order":392.484375,"custom_state":""}
-->