PUT versus POST

Published on May 11, 2007

I have seen many conflicting descriptions of the uses of PUT and POST. The description below is quite clear and leads me to wonder why so many people confuse the two.

From here in the HTML spec,

"The fundamental difference between the POST and PUT requests is reflected in the different meaning of the Request-URI. The URI in a POST request identifies the resource that will handle the enclosed entity. That resource might be a data-accepting process, a gateway to some other protocol, or a separate entity that accepts annotations. In contrast, the URI in a PUT request identifies the entity enclosed with the request -- the user agent knows what URI is intended and the server MUST NOT attempt to apply the request to some other resource."