---
title: "Changes to Deletes multiple cases. It is required to supply exactly one of either  caseIds or query in the request body. If caseIds are supplied, cases  corresponding to those caseIds will be deleted. If query is supplied,  all cases that match the query will be deleted."
method: DELETE
path: "/cases"
---

# Changes to Deletes multiple cases. It is required to supply exactly one of either  caseIds or query in the request body. If caseIds are supplied, cases  corresponding to those caseIds will be deleted. If query is supplied,  all cases that match the query will be deleted.

`DELETE /cases`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 70 revisions.

- **2026-07-17** `886deae8a6f9`: 3 info
- **2020-09-09** `a14b106f1592`: 1 breaking
- **2020-09-08** `dbe1dd630da2`: 2 info
- **2020-09-08** `46a561a92386`: 1 warning, 1 info
- **2020-09-07** `40b6e56b7df5`: 2 info
- **2020-08-28** `ae5e11151c5d`: 1 warning
- **2020-08-28** `97da90099900`: 1 warning
- **2020-08-28** `8af652dbe16a`: 1 warning
- **2020-08-27** `95fc3703a2e2`: 1 breaking
- **2020-08-27** `093e0176ec63`: 1 breaking, 2 info

## Changes

- **2026-07-17** `886deae8a6f9`: 3 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `422`
- **2020-09-09** `a14b106f1592`: 1 breaking
  - added the pattern `^[a-f\d]{24}$` to the request property `caseIds/items/`
- **2020-09-08** `dbe1dd630da2`: 2 info
  - added the new optional request property `maxCasesThreshold`
  - added the non-success response with the status `422`
- **2020-09-08** `46a561a92386`: 1 warning, 1 info
  - removed the request property `maxCasesThreshold`
  - removed the non-success response with the status `422`
- **2020-09-07** `40b6e56b7df5`: 2 info
  - added the new optional request property `maxCasesThreshold`
  - added the non-success response with the status `422`
- **2020-08-28** `ae5e11151c5d`: 1 warning
  - changed the pattern of the request property `query` from `^(?!\s*$).+` to `\S+`
- **2020-08-28** `97da90099900`: 1 warning
  - changed the pattern of the request property `query` from `\S+` to `^(?!\s*$).+`
- **2020-08-28** `8af652dbe16a`: 1 warning
  - changed the pattern of the request property `query` from `^(?!\s*$).+` to `\S+`
- **2020-08-27** `95fc3703a2e2`: 1 breaking
  - added the pattern `^(?!\s*$).+` to the request property `query`
- **2020-08-27** `093e0176ec63`: 1 breaking, 2 info
  - the request's body type changed from no type to `object`
  - added the new optional request property `query`
  - added `subschema #1, subschema #2` to the request body `oneOf` list

---

[Operation](https://skmtc.dev/globaldothealth/apis/global-health-data-service/docs/cases/delete.md) - [API](https://skmtc.dev/globaldothealth/apis/global-health-data-service.md) - [Page](https://skmtc.dev/globaldothealth/apis/global-health-data-service/changes/cases/delete)
