document user api service.

`PUT`s are meant to be idempotent. Use sphinxcontrib-httpdomain==1.2.0 to document it in sphinx.