---
title: "Delete a bunch of documents"
method: DELETE
path: "/collections/{collectionName}/documents"
tags: ["documents"]
---

# Delete a bunch of documents

`DELETE /collections/{collectionName}/documents`

Delete a bunch of documents that match a specific filter condition. Use the `batch_size` parameter to control the number of documents that should deleted at a time. A larger value will speed up deletions, but will impact performance of other operations running on the server.

## Path parameters

- `collectionName` string, required

## Query parameters

- `deleteDocumentsParameters` object
  - `filter_by` string, required
  - `batch_size` integer — Batch size parameter controls the number of documents that should be deleted at a time. A larger value will speed up deletions, but will impact performance of other operations running on the server.
  - `ignore_not_found` boolean
  - `truncate` boolean — When true, removes all documents from the collection while preserving the collection and its schema.

## Response `200`

Documents successfully deleted

- object
  - `num_deleted` integer, required

## Other responses

- `404` — Collection not found

---

[API](https://skmtc.dev/typesense/apis/typesense-api.md) · [All operations](https://skmtc.dev/typesense/apis/typesense-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/typesense/typesense-api/revisions/1d9b3b61638e/schema)