deleteDocument

Delete a stored document, or all stored documents matching a search filter.

There is a small delay between the time a document is deleted and it being reflected in the search layer (usually a couple of seconds). That means that a document that was just deleted might still be returned by this function.


deleteDocument(documentId, [options], [callback])

Arguments Type Description
documentId string Unique document identifier
options JSON object Optional parameters
callback function Optional callback

deleteDocument(filters, [options], [callback])

Arguments Type Description
filters JSON object Filters in ElasticSearch Query DSL format
options JSON object Optional parameters
callback function Optional callback

Options

Option Type Description Default
volatile JSON object Additional information passed to notifications to other users null
queuable boolean Make this request queuable or not true
refresh string If set to wait_for, Kuzzle will wait for the persistence layer to finish indexing (available with Elasticsearch 5.x and above) undefined

Return Value

Returns the Collection object to allow chaining.


Callback Response

Returns an array containing the ids of the deleted documents.

Usage

Copied to clipboard!

<?php

use \Kuzzle\Kuzzle;

$kuzzle = new Kuzzle('localhost');
$dataCollection = $kuzzle->collection('collection', 'index');

// Deleting one document
try {
  $result = $dataCollection->deleteDocument('documentId');
}
catch (ErrorException $e) {

}

// Deleting multiple documents
$filters = [
  'filter' => [
    'equals' => ['field' => 'value']
  ]
];

try {
  $result = $dataCollection->deleteDocument($filters);
}
catch (ErrorException $e) {

}

Callback response:

Copied to clipboard!
["AVCoeBkimsySTKTfa8AX"]