PUT request method

Syntax

PUT <request-target>["?"<query>] HTTP/1.1

<request-target>

Identifies the target resource of the request when combined with the information provided in the Host header. This is an absolute path (e.g., /path/to/file.html) in requests to an origin server, and an absolute URL in requests to proxies (e.g., http://www.example.com/path/to/file.html).

<query> Optional

An optional query component preceded by a question-mark ?. Often used to carry identifying information in the form of key=value pairs.

Examples

Successfully creating a resource

PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16

<p>New File</p>

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

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

Specifications

Browser compatibility

See also

• HTTP request methods
• HTTP response status codes
• HTTP headers
• 201 Created, 204 No Content response statuses