Skip to content

Delete documents

Delete documents identified by an array of their IDs.


POST /indexes/{index_name}/documents/delete-batch

Path parameters

Name Type Description
index_name String name of the index

Body

An array of document IDs, to be deleted.

[ "article_591", "article_602" ]

Example

curl -XPOST  http://localhost:8882/indexes/my-first-index/documents/delete-batch -H 'Content-type:application/json' -d '[
  "article_591", "article_602"
]'
mq.index("my-first-index").delete_documents(ids=["article_591", "article_602"])

Response 200 OK

{
    "details": {"deletedDocuments": 2, "receivedDocumentIds": 2},
    "duration": "PT0.048207S",
    "finishedAt": "2024-01-16T23:51:25.521119Z",
    "index_name": "my-first-index",
    "items": [
        {"_id": "article_591", "result": "deleted", "status": 200},
        {"_id": "article_602", "result": "deleted", "status": 200},
    ],
    "startedAt": "2024-01-16T23:51:25.472912Z",
    "status": "succeeded",
    "type": "documentDeletion",
}
In this example, one of the articles didn't exist in the index. Therefore, only one document was deleted.