6.1.3. Including Attachments

You can include one or more attachments with a given document by incorporating the attachment information within the JSON of the document. This provides a simpler alternative to loading documents with attachments than making a separate call (see Section 6.8, “PUT /db/doc/attachment).

Table 6.3.  Document with Attachments

FieldDescription
_id (optional) Document ID
_rev (optional) Revision ID (when updating an existing document)
_attachments (optional) Document Attachment
        filename Attachment information
                content_type MIME Content type string
                data File attachment content, Base64 encoded

The filename will be the attachment name. For example, when sending the JSON structure below:

{
   "_id" : "FishStew",
   "servings" : 4,
   "subtitle" : "Delicious with fresh bread",
   "title" : "Fish Stew"
   "_attachments" : {
      "styling.css" : {
         "content-type" : "text/css",
         "data" : "cCB7IGZvbnQtc2l6ZTogMTJwdDsgfQo=",
         },
   },
}

The attachment styling.css can be accessed using /recipes/FishStew/styling.css. For more information on attachments, see Section 6.7, “GET /db/doc/attachment.

The document data embedded in to the structure must be encoded using base64.