---
title: "Changes to Batch Delete Documents"
method: DELETE
path: "/v1/collections/{collection_identifier}/documents/batch"
---

# Changes to Batch Delete Documents

`DELETE /v1/collections/{collection_identifier}/documents/batch`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 76 revisions.

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
- **2026-10-04** `38e0822db900`: 1 info
- **2026-09-26** `5231c1d891e8`: 3 info
- **2026-08-30** `3775e0b36ee1`: 2 breaking, 2 info
- **2026-08-09** `5d4c905106b4`: 1 info
- **2026-08-05** `fdb4bdd01a64`: 1 info
- **2026-07-26** `7cb051533311`: 9 info

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - added the required property `error` to the response with the `422` status
  - added the required property `status` to the response with the `422` status
- **2026-10-04** `38e0822db900`: 1 info
  - added the optional property `limits` to the response with the `200` status
- **2026-09-26** `5231c1d891e8`: 3 info
  - added the new `words` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `words` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `words` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
- **2026-08-30** `3775e0b36ee1`: 2 breaking, 2 info
  - the response property `deleted_count` became optional for the status `200`
  - response property `deleted_count` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `status` to the response with the `200` status
  - added the optional property `task_id` to the response with the `200` status
- **2026-08-09** `5d4c905106b4`: 1 info
  - the endpoint scheme security `BearerAuth AND NamespaceHeader` was added to the API
- **2026-08-05** `fdb4bdd01a64`: 1 info
  - added the new optional request property `reason`
- **2026-07-26** `7cb051533311`: 9 info
  - added the new `geo_bounding_box` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_bounding_box` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_bounding_box` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_polygon` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_polygon` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_polygon` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_radius` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/AND/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_radius` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/NOT/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`
  - added the new `geo_radius` enum value to the request property `filters/anyOf[subschema #1: LogicalOperator]/OR/anyOf[subschema #1]/items/anyOf[subschema #2: FilterCondition]/operator`

---

[Operation](https://skmtc.dev/mixpeek/apis/mixpeek-api/docs/v1/collections/:collection_identifier/documents/batch/delete.md) - [API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) - [Page](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/collections/:collection_identifier/documents/batch/delete)