PUT

The PUT method is used to update a mutable resource and must always include the resource locator. The PUT method calls are also idempotent in that multiple requests will not mutate the resource to a different state than the first call.

Request:

PUT /v1/cats HTTP/1.1 
Content-Type: application/json 
Content-Length: xxxx 

{"name": "Thomas", "weight": 7 } 

Response:

HTTP/1.1 201 Created 
Content-Type: application/json 
Content-Length: 0