Core 2.x

createOrReplace

Creates a new document in the persistent data storage, or replaces its content if it already exists.

The optional parameter refresh can be used with the value wait_for in order to wait for the document to be indexed (indexed documents are available for search).


Copied to clipboard!
createOrReplace(index, collection, id, document, [options]);
Argument Type Description
index
string
Index name
collection
string
Collection name
id
string
Document ID
document
object
Document content
options
object
Query options

Options

Additional query options

Options Type
(default)
Description
queuable
boolean

(true)
If true, queues the request during downtime, until connected to Kuzzle again
refresh
string

("")
If set to wait_for, waits for the change to be reflected for search (up to 1s)

Resolves

Resolves to an object containing the document creation result.

Name Type Description
_id
string
The id of the newly created document
_version
number
The version of the document in the persistent data storage
_source
object
The created document

Usage

Copied to clipboard!
try {
  const response = await kuzzle.document.createOrReplace(
    'nyc-open-data',
    'yellow-taxi',
    'some-id',
    { lastName: 'McHan' }
  );
  console.log(response);
  /*
    response =
    { _id: 'some-id',
      _version: 1,
      created: true,
      _source:
        { lastName: 'McHan',
          _kuzzle_info:
            { author: '-1',
              createdAt: 1537443212089,
              updatedAt: null,
              updater: null } } }
   */
} catch (error) {
  console.error(error.message);
}