How do I test a RESTful PUT (or DELETE) method using cURL?
5 Answers
Using the majuscule -X
flag with whatever HTTP verb you want:
curl -X PUT -d argument=value -d argument2=value2 http://localhost:8080
This example also uses the -d
flag to provide arguments with your PUT request.
-
26"man curl" on -X: "Normally you don't need this option. All sorts of GET, HEAD, POST and PUT requests are rather invoked by using dedicated command line options." But I couldn't find another way. Nov 26, 2013 at 15:18
-
53
-
2As Martin C. Martin's answer also changes to GET after a redirect from the server this is the more useful answer in my opinion.– MartinOct 2, 2015 at 12:10
-
2
-
1Curl 7.47 and this would not work for me. theabraham's answer always defaults to post behavior. --get (or -G) however will force the -d (--data) fields to become url parameters and does work. Jun 4, 2017 at 1:49
Quick Answer:
In a single line, the curl command would be:
If sending form data:
curl -X PUT -H "Content-Type: multipart/form-data;" -F "key1=val1" "YOUR_URI"
If sending raw data as json:
curl -X PUT -H "Content-Type: application/json" -d '{"key1":"value"}' "YOUR_URI"
If sending a file with a POST request:
curl -X POST "YOUR_URI" -F 'file=@/file-path.csv'
Alternative solution:
You can use the POSTMAN app from Chrome Store to get the equivalent cURL request. This is especially useful when writing more complicated requests.
For the request with other formats or for different clients like java, PHP, you can check out POSTMAN/comment below.
-
6No idea why this has been downvoted... I copied here the idea how to pass JSON body for curl PUT. Also postman is pretty awesome tool to get curl code for more complicated queries :) Mar 30, 2016 at 14:40
-
2Thanks !! Even I don't have any idea why about the downvotes. Might be reluctance of the users to adopt it. I have created a respo of all my REST apis for mobile in POSTMAN and that is the best productivity tip that I can suggest to anyone working with REST.– PrateekMar 31, 2016 at 6:02
-
Real world example where I'm passing json data and parameter in the end point; curl -X PUT -H "Content-Type: application/json" -d '{"amount":"999","type":"car","parent_id":"12345"}' localhost:8080/transactionservice/transaction/2222– vikramviSep 6, 2017 at 5:14
-
1Having to install a complete browser (if one doesn't have Chrome) and an extension for it might be an overkill for some people imho. At least you could have provided an alternative for another more common (default installation) web browser like Firefox, where the HttpRequester does a similar job. Mar 2, 2018 at 13:33
-
7
An example PUT following Martin C. Martin's comment:
curl -T filename.txt http://www.example.com/dir/
With -T
(same as --upload-file
) curl will use PUT for HTTP.
-
10Unfortunately, the
-T
is no substitute for-X PUT
if you want to specify parameters with-d
or-F
.-T
sends the content of a file via PUT. To achieve theGET
after a redirect, add the parameter--location
– Martin MOct 23, 2015 at 9:23 -
I am late to this thread, but I too had a similar requirement. Since my script was constructing the request for curl dynamically, I wanted a similar structure of the command across GET, POST and PUT.
Here is what works for me
For PUT request:
curl --request PUT --url http://localhost:8080/put --header 'content-type: application/x-www-form-urlencoded' --data 'bar=baz&foo=foo1'
For POST request:
curl --request POST --url http://localhost:8080/post --header 'content-type: application/x-www-form-urlencoded' --data 'bar=baz&foo=foo1'
For GET request:
curl --request GET --url 'http://localhost:8080/get?foo=bar&foz=baz'
curl -X PUT -d 'new_value' URL_PATH/key
where,
X - option to be used for request command
d - option to be used in order to put data on remote url
URL_PATH - remote url
new_value - value which we want to put to the server's key