PUT vs POST in RESTful services?

Hello, I would like to know the difference between PUT & POST in Restful services.

As I am using Web API, I feel put and post are same or almost same but doesn't have any idea about when to which one.

Asked by:- Vinnu
: 3024 At:- 3/28/2018 1:06:30 PM
rest web api put post

3 Answers
profileImage Answered by:- pika


HTTP Put and post are not equivalent to Create/Update in CRUD operations.

You should use Post to create a new data, suppose for example you are creating a new article, you can pass data using POST

So use POST when you don't have any idea where to store it, you can POST it to an URL, and let the server decide the actual URL.

POST /articles HTTP/1.1
    <title>Testing POST</title>
    <price currency="eur">7.50</price>

HTTP/1.1 201 Created
Location: /articles/1212

Use PUT when you have an actual location or you can say complete URL with Id to update data for an article(as in above example), you can use PUT

PUT /article/1234 HTTP/1.1
    <title>Updated title</title>
    <price currency="eur">12.50</price>

As soon as you know the new resource location, you can use PUT again to do updates, you can also use PUT for adding new data.

PUT is idempotent, while POST is not.


Better is to choose between PUT and POST based on idempotence of the action.

PUT implies putting a resource - completely replacing whatever is available at the given URL with a different thing. By definition, a PUT is idempotent. Do it as many times as you like, and the result is the same. x=5 is idempotent. You can PUT a resource whether it previously exists, or not (eg, to Create, or to Update)!

POST updates a resource, adds a subsidiary resource or causes a change. A POST is not idempotent, in the way that x++ is not idempotent.

by consider above argument, we can say, PUT is for creating when you know the URL of the thing you will create. POST can be used to create when you know the URL of the "factory" or manager for the category of things you want to create.

At:- 3/29/2018 9:21:14 AM
now my concepts are clear regarding PUT & POST, thanks 0
By : Vinnu - at :- 4/13/2018 10:46:58 AM

profileImage Answered by:- neena

If you take a look at page 55 of RFC 2616 (“Hypertext Transfer Protocol – HTTP/1.1”), There’s also a handy paragraph to explain the difference between POST and PUT:

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.

But it doesn’t mention anything about the difference between updating/creating, because that’s not what it’s about. It’s about the difference between this:

obj.set_attribute(value) # A POST request. 

And this:

obj.attribute = value # A PUT request.  

Reference Link

At:- 4/11/2018 9:11:21 AM

profileImage Answered by:- vikas_jk

POST means to "create new" as in "Here is the input for creating a user, create it for me".

PUT means "insert new data OR replace data if already exists" as in "Here is the data for user 5".

Sample C# Code for each one of them

POST example

        // POST: api/Demo
        public IHttpActionResult Post(TableModel data)
                if (data == null)
                    return BadRequest();
                return Created<TableModel>(Request.RequestUri
                                           + "/" + data.Id.ToString(), data);

            catch (Exception)
                return InternalServerError();

In here, we do not check whether the id is existing or not in the payload, because the EF would assign a new id to the new entity.

PUT example:

[HttpPut, Route("{id,:int}")]
        // PUT: api/Demo/5
        public IHttpActionResult Put(int id, TableData data)
                var existingEntity = db.TableData.FindAsync(id);
                if (existingEntity == null)
                    return NotFound();
                if(data == null)
                    return BadRequest();
                db.Entry(existingEntity).State = EntityState.Modified;

                return Ok(existingEntity);
            catch (Exception)

                return InternalServerError();

In the above PUT here we are checking whether the requested id existing or not before we doing the update.

At:- 5/8/2020 2:43:55 PM

Login/Register to answer
Register directly by posting answer/details

Full Name *

Email *

By posting your answer you agree on privacy policy & terms of use