|  May   
[ Safe ](/en-US/docs/Glossary/Safe/HTTP) |  No   
[ Idempotent ](/en-US/docs/Glossary/Idempotent) |  Yes   
[ Cacheable ](/en-US/docs/Glossary/Cacheable) |  No   
Allowed in [ HTML forms ](/en-US/docs/Learn/Forms) |  No   
  
##  Syntax

http

    
    
    PUT /new.html HTTP/1.1
    

##  Example

###  Request

http

    
    
    PUT /new.html HTTP/1.1
    Host: example.com
    Content-type: text/html
    Content-length: 16
    
    <p>New File</p>
    

###  Responses

If the target resource does not have a current representation and the ` PUT `
request successfully creates one, then the origin server must inform the user
agent by sending a [ ` 201 ` ](/en-US/docs/Web/HTTP/Status/201) ( ` Created `
) response.

http

    
    
    HTTP/1.1 201 Created
    Content-Location: /new.html
    

If the target resource does have a current representation and that
representation is successfully modified in accordance with the state of the
enclosed representation, then the origin server must send either a [ ` 200 `
](/en-US/docs/Web/HTTP/Status/200) ( ` OK ` ) or a [ ` 204 ` ](/en-
US/docs/Web/HTTP/Status/204) ( ` No Content ` ) response to indicate
successful completion of the request.

http

    
    
    HTTP/1.1 204 No Content
    Content-Location: /existing.html
    

##  Specifications

Specification  
---  
[ HTTP Semantics  
#  PUT  ](https://www.rfc-editor.org/rfc/rfc9110#PUT)  
  
##  Browser compatibility

BCD tables only load in the browser  with JavaScript enabled. Enable
JavaScript to view data.

##  See also

  * [ ` 201 ` ](/en-US/docs/Web/HTTP/Status/201)
  * [ ` 204 ` ](/en-US/docs/Web/HTTP/Status/204)

##  Help improve MDN

Was this page helpful to you?

Yes  No

[ Learn how to contribute
](https://github.com/mdn/content/blob/main/CONTRIBUTING.md "This will take you
to our contribution guidelines on GitHub.") .

This page was last modified on  Apr 10, 2023  by  [ MDN contributors ](/en-
US/docs/Web/HTTP/Methods/PUT/contributors.txt) .

[ View this page on GitHub
](https://github.com/mdn/content/blob/main/files/en-
us/web/http/methods/put/index.md?plain=1 "Folder: en-us/web/http/methods/put
\(Opens in a new tab\)") â¢  [ Report a problem with this content
](https://github.com/mdn/content/issues/new?template=page-report.yml&mdn-
url=https%3A%2F%2Fdeveloper.mozilla.org%2Fen-
US%2Fdocs%2FWeb%2FHTTP%2FMethods%2FPUT&metadata=%3C%21--+Do+not+make+changes+below+this+line+--%3E%0A%3Cdetails%3E%0A%3Csummary%3EPage+report+details%3C%2Fsummary%3E%0A%0A*+Folder%3A+%60en-
us%2Fweb%2Fhttp%2Fmethods%2Fput%60%0A*+MDN+URL%3A+https%3A%2F%2Fdeveloper.mozilla.org%2Fen-
US%2Fdocs%2FWeb%2FHTTP%2FMethods%2FPUT%0A*+GitHub+URL%3A+https%3A%2F%2Fgithub.com%2Fmdn%2Fcontent%2Fblob%2Fmain%2Ffiles%2Fen-
us%2Fweb%2Fhttp%2Fmethods%2Fput%2Findex.md%0A*+Last+commit%3A+https%3A%2F%2Fgithub.com%2Fmdn%2Fcontent%2Fcommit%2F0880a90f3811475d78bc4b2c344eb4146f25f66c%0A*+Document+last+modified%3A+2023-04-10T19%3A47%3A15.000Z%0A%0A%3C%2Fdetails%3E
"This will take you to GitHub to file a new issue.")

[ MDN logo  ](/)

Your blueprint for a better internet.

  * [ MDN on Mastodon  ](https://mozilla.social/@mdn)
  * [ MDN on X (formerly Twitter)  ](https://twitter.com/mozdevnet)
  * [ MDN on GitHub  ](https://github.com/mdn/)
  * [ MDN Blog RSS Feed  ](/en-US/blog/rss.xml)

##  MDN

  * [ About ](/en-US/about)
  * [ Blog ](/en-US/blog/)
  * [ Careers ](https://www.mozilla.org/en-US/careers/listings/?team=ProdOps)
  * [ Advertise with us ](/en-US/advertising)

##  Support

  * [ Product help ](https://support.mozilla.org/products/mdn-plus)
  * [ Report an issue ](/en-US/docs/MDN/Community/Issues)

##  Our communities

  * [ MDN Community ](/en-US/community)
  * [ MDN Forum ](https://discourse.mozilla.org/c/mdn/236)
  * [ MDN Chat ](/discord)

##  Developers

  * [ Web Technologies ](/en-US/docs/Web)
  * [ Learn Web Development ](/en-US/docs/Learn)
  * [ MDN Plus ](/en-US/plus)
  * [ Hacks Blog ](https://hacks.mozilla.org/)

[ Mozilla logo  ](https://www