CouchDB - Updating a Document

Updating Documents using cURL

You can update a document in CouchDB by sending an HTTP request to the server using PUT method through cURL utility. Following is the syntax to update a document.

curl -X PUT -d '{ "field" : "value", "_rev" : "revision id" }'


Suppose there is a document with id 001 in the database named my_database. You can delete this as shown below.

First of all, get the revision id of the document that is to be updated. You can find the _rev of the document in the document itself, therefore get the document as shown below.

$ curl -X GET
   "_id" : "001",
   "_rev" : "2-04d8eac1680d237ca25b68b36b8899d3 " ,
   "age" : "23"

Use revision id _rev from the document to update the document. Here we are updating the age from 23 to 24.

$ curl -X PUT -d
' { " age " : " 24 " , " _rev " : " 1-1c2fae390fa5475d9b809301bbf3f25e " } '

{ " ok " : true , " id " : " 001 " , " rev " : " 2-04d8eac1680d237ca25b68b36b8899d3 " }


To verify the document, get the document again using GET request as shown below.

$ curl -X GET
   " _id " : " 001 ",
   " _rev " : " 2-04d8eac1680d237ca25b68b36b8899d3 " ,
   " age " : " 23 "

Following are some important points to be noted while updating a document.

  • The URL we send in the request containing the database name and the document id.

  • Updating an existing document is same as updating the entire document. You cannot add a field to an existing document. You can only write an entirely new version of the document into the database with the same document ID.

  • We have to supply the revision number as a part of the JSON request.

  • In return JSON contains the success message, the ID of the document being updated, and the new revision information. If you want to update the new version of the document, you have to quote this latest revision number.

Updating Documents using Futon

To delete a document open the url to get an Overview/index page of CouchDB as shown below.

Create Document

Select the database in which the document to be updated exists and click it. Here we are updating a document in the database named tutorials_point. You will get the list of documents in the database as shown below.

Update Document

Select a document that you want to update and click on it. You will get the contents of the documents as shown below.

Document Contents

Here, to update the location from Delhi to Hyderabad, click on the text box, edit the field, and click the green button to save the changes as shown below.

Save Changes
Kickstart Your Career

Get certified by completing the course

Get Started