HTTP PUT Request Message

An HTTP PUT Request Message is an HTTP request message that requests an HTTP PUT Method.

• Context:
  • …
• Example(s):
  • PUT /user/john HTTP/1.1
  • PUT /user/john/profile HTTP/1.1
  • PUT /user/john/password HTTP/1.1
  • …
• Counter-Example(s):
  • a HTTP POST Request, which submits data to be processed to a specified resource
  • a HEAD Request, which only returns HTTP headers and no document body
• See: HTTP URL Query String, Idempotence, HTTP Response, Web Resource, Form (HTML).

---

---

References

2023

• (Wikipedia, 2023) ⇒ http://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Request_methods Retrieved:2013-12-19.
  • PUT: The PUT method requests that the target resource create or update its state with the state defined by the representation enclosed in the request. A distinction from POST is that the client specifies the target location on the server.

2022

• https://datatracker.ietf.org/doc/html/rfc9110#name-put
  • 9.3.4. PUT

    The PUT method requests that the state of the target resource be created or replaced with the state defined by the representation enclosed in the request message content. A successful PUT of a given representation would suggest that a subsequent GET on that same target resource will result in an equivalent representation being sent in a 200 (OK) response. However, there is no guarantee that such a state change will be observable, since the target resource might be acted upon by other user agents in parallel, or might be subject to dynamic processing by the origin server, before any subsequent GET is received. A successful response only implies that the user agent's intent was achieved at the time of its processing by the origin server. ...

---