diff --git a/README.md b/README.md
index 11c11908..26094203 100644
--- a/README.md
+++ b/README.md
@@ -246,15 +246,16 @@ alias for `nano.use`
 
 makes a request to couchdb, the available `opts` are:
 
-* `opts.db` - the database name
-* `opts.method` - the http method, defaults to `get`
-* `opts.path` - the full path of the request, overrides `opts.doc` and
+* `opts.db` – the database name
+* `opts.method` – the http method, defaults to `get`
+* `opts.path` – the full path of the request, overrides `opts.doc` and
   `opts.att`
-* `opts.doc` - the document name
-* `opts.att` - the attachment name
-* `opts.content_type` - the content type of the request, default to `json`
-* `opts.body` - the document or attachment body
-* `opts.encoding` - the encoding for attachments
+* `opts.doc` – the document name
+* `opts.att` – the attachment name
+* `opts.content_type` – the content type of the request, default to `json`
+* `opts.headers` – additional http headers, overrides existing ones
+* `opts.body` – the document or attachment body
+* `opts.encoding` – the encoding for attachments
 
 ### nano.relax(opts, [callback])
 
diff --git a/nano.js b/nano.js
index 9f65ed28..ffb944c4 100644
--- a/nano.js
+++ b/nano.js
@@ -78,6 +78,7 @@ module.exports = exports = nano = function database_module(cfg) {
   *        {opts.path:string:optional} a full path, override `doc` and `att`
   *        {opts.doc:string:optional} document name
   *        {opts.att:string:optional} attachment name
+  *        {opts.headers:object:optional} additional http headers
   *        {opts.content_type:string:optional} content type, default to json
   *        {opts.body:object|string|binary:optional} document or attachment body
   *        {opts.encoding:string:optional} encoding for attachments