Use the data property

This is for:

Developer System Administrator

You should only use the data property when you want to push 5 MB or less of raw textual item data.

In spite of its limited flexibility, this property is very convenient when performing simple Push API tests, due to its inherent simplicity.

Important

Ensure that you properly escape reserved JSON characters (newline, tab, double quote, backslash, etc.) in your data string.

Use the data property when pushing a single item

The following example shows how you can use the data property to specify item data when performing a PUT /sources/{sourceId}/documents HTTP request.

Sample request

Request definition

PUT https://api.cloud.coveo.com/push/v1/organizations/mycoveocloudv2organizationg8tp8wu3/sources/mycoveocloudv2organization-rp5rxzbdz753uhndklv2ztkfgy/documents?documentId=file://example.html HTTP/1.1
​
Content-Type: application/json
Accept: application/json
Authorization: Bearer **********-****-****-****-************

Request body

{
  // ...Item metadata...
  "data": "<html><head></head><body><h1>Example</h1><p>This is an \"example\".</p></body></html>",
  "fileExtension": ".html",
  // ...Item permission model (if applicable)...
}

Successful response - 202 Accepted

{}

Use the data property when uploading a batch of items

The following example shows how you can use the data property to specify item data when uploading content into a file container with a PUT uploadUri HTTP request.

Sample request

Request definition

PUT link:https://coveo-nprod-customerdata.s3.amazonaws.com/proda/blobstore/mycoveocloudv2organizationg8tp8wu3/b5e8767e-8f0d-4a89-9095-1127915c89c7[...] HTTP/1.1
​
x-amz-server-side-encryption: AES256
Content-Type: application/octet-stream

Request body

{
  "addOrUpdate": [
    {
      // ...Item metadata...
      "documentId": "file://example.html",
      "data": "<html><head></head><body><h1>Example</h1><p>This is an \"example\".</p></body></html>",
      "fileExtension": ".html",
      // ...Item permission model (if applicable)...
    },
    // ...More items to add or update...
  ],
  "delete": [
    // ...Items to delete...
  ]
}

Successful response - 200 OK

{}