PUT Request

Search for glossary terms (regular expression allowed)
PUT Request

A PUT request is an HTTP method used to update or replace a resource entirely at a specific URI. If the resource does not exist at the specified URI, the PUT request can also be used to create a new resource.


Understanding HTTP requests is crucial for effective web development and application programming communication between clients and servers. The PUT request is significant among the various HTTP methods, particularly in updating and modifying existing resources. This article delves into PUT requests, how they operate, and their appropriateness in different scenarios, providing developers with a comprehensive understanding crucial for building responsive and dynamic web applications.

What is a PUT request?

A PUT request is a fundamental HTTP method for updating existing resources on a server or creating new ones if they don't exist. Unlike the GET request, which retrieves data from a server, or the POST request, often used to develop new resources, PUT requests are idempotent. This means that making the same PUT request multiple times will always produce the same result, ensuring the stability and predictability of data modifications.

The primary purpose of a PUT request is to update all resources available on the server. For instance, if a resource associated with a specific URL contains certain information, a PUT request could replace the existing information with new data provided by the client.

How does a PUT request work?

The syntax for a PUT request includes:

  • The method itself (PUT).
  • The target URI (Uniform Resource Identifier).
  • The HTTP version.
  • Headers.
  • An optional message body containing the data to update.

Here's a basic structure of how a PUT request might look:

PUT /user/123 HTTP/1.1Host: example.com

Content-Type: application/json
{"name": "Jane Doe", "email": "

When a client sends a PUT request to a server, it asks the server to update the resource with the new data at the specified URI (if it exists). If successful, the server processes the request, updates the resource, and returns a 200 (OK) or 204 (No Content) status code. If the resource does not exist, and the server can create it based on the request URI, it may respond with a 201 (Created) status code.

Examples of PUT requests

PUT requests are commonly used in various applications to maintain up-to-date information on the server. Here are some examples:

  • Updating User Profiles: Consider a social networking site where users can update their profiles. A PUT request can update a user's information, such as name or email.
  • fetch('https://api.example.com/user/123', { method: 'PUT', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ name: 'Jane Doe', email: ''  })});
  • Editing Blog Posts: Authors may need to update their blog posts for a blogging platform. A PUT request facilitates this by replacing the content of an existing post with new data.
  • Modifying Product Information: E-commerce platforms utilize PUT requests to update product details, such as prices, descriptions, and stock levels.

These examples underline how PUT requests enable efficient and direct updates to specified resources, making them indispensable for dynamic and interactive web applications.


PUT requests play a pivotal role in web development, providing a standard method for updating existing resources on a server. Their idempotent nature ensures reliability and predictability in data management tasks. By understanding how to use PUT requests effectively, developers can ensure the integrity of data updates, enhance user experience, and build robust web applications. As technologies evolve, the importance of mastering HTTP methods like PUT remains ever-relevant, encouraging further exploration of advanced web development techniques.