• Now all data be ready for publish, We had made our blog alive now. Haha.

  • These days CCP GFW blocked all the IPs from US and when I switch my IP in google Cloud, the disk data cannot be restore again. I have to restart my blog totally, Now the website is still building…

PUT vs. POST in REST- Stack Overflow

Python PingBook 1 months ago (10-26) 17 0


According to the HTTP/1.1 Spec:

The POST method is used to request that the origin server accept the entity enclosed in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line

In other words, POST is used to create.

The PUT method requests that the enclosed entity be stored under the supplied Request-URI. If the Request-URI refers to an already existing resource, the enclosed entity SHOULD be considered as a modified version of the one residing on the origin server. If the Request-URI does not point to an existing resource, and that URI is capable of being defined as a new resource by the requesting user agent, the origin server can create the resource with that URI.”

That is, PUT is used to create or update.

So, which one should be used to create a resource? Or one needs to support both?



Both PUT and POST can be used for creating.

You have to ask “what are you performing the action to?” to distinguish what you should be using. Let’s assume you’re designing an API for asking questions. If you want to use POST then you would do that to a list of questions. If you want to use PUT then you would do that to a particular question.

Great both can be used, so which one should I use in my RESTful design:

You do not need to support both PUT and POST.

Which is used is left up to you. But just remember to use the right one depending on what object you are referencing in the request.

Some considerations:

Do you name your URL objects you create explicitly, or let the server decide? If you name them then use PUT. If you let the server decide then use POST.
PUT is idempotent, so if you PUT an object twice, it has no effect. This is a nice property, so I would use PUT when possible.
You can update or create a resource with PUT with the same object URL
With POST you can have 2 requests coming in at the same time making modifications to a URL, and they may update different parts of the object.

An example:

I wrote the following as part of another answer on SO regarding this:


Used to modify and update a resource

POST /questions/ HTTP/1.1
Host: http://www.example.com/

Note that the following is an error:

POST /questions/ HTTP/1.1
Host: http://www.example.com/

If the URL is not yet created, you
should not be using POST to create it
while specifying the name. This should
result in a ‘resource not found’ error
because does not exist
yet. You should PUT the
resource on the server first.

You could though do something like
this to create a resources using POST:

POST /questions HTTP/1.1
Host: http://www.example.com/

Note that in this case the resource
name is not specified, the new objects
URL path would be returned to you.


Used to create a resource, or
overwrite it. While you specify the
resources new URL.

For a new resource:

PUT /questions/ HTTP/1.1
Host: http://www.example.com/

To overwrite an existing resource:

PUT /questions/ HTTP/1.1
Host: http://www.example.com/

Copyright from PingBook Blog, If not specified, they are original. This site uses BY-NC-SAProtocol authenticated.
For reprinting, please indicate the link of the original text:PUT vs. POST in REST- Stack Overflow
LIKE (0)
We create, We sharing! Tag every value data your sharing
Submit comments
Cancel comments
emoji picture bold strikethrough center italic check in

Hi,you need to provide your name and email adress!

  • Name (Required)
  • Email (Required)
  • Website