HTTP PUT example

We can perform an update to our representation with the following URL. Take note of the HTTP verb PUT.

The documentation has said that we can call a PUT method at the following resource and also note the /star as part of the URI. PUT is used to modify our representation. Generally, PUT will have a body. In the gist API for GitHub, they have made it simpler. Generally, the notion is for PUT to look similar to POST, except that the URI contains the identifier that was received when the POST method was called:

PUT behaves similar to POST when a resource does not exist. In our example from POST, if you had to call PUT the very first time with the POST request to create a contact instead, then you would receive 201, informing you that the resource was created. Then, if you had to call the request on PUT again, you will get back 200 with the same data. In this way, PUT is idempotent.