PUT

Creates or replaces the state of a resource at a known target URI.

Use PUT when the client supplies the complete replacement representation and repeated requests should have the same intended effect.

PUT /api/users/42 HTTP/1.1
Content-Type: application/json