---
title: "Changes to Batch upserts cases"
method: POST
path: "/cases/batchUpsert"
---

# Changes to Batch upserts cases

`POST /cases/batchUpsert`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 20 of 50 revisions.

- **2026-07-17** `886deae8a6f9`: 1 info
- **2022-04-29** `e11f54229b64`: 2 warning
- **2022-01-14** `1619bcaae2df`: 2 breaking, 2 warning
- **2022-01-06** `875e892119b9`: 1 info
- **2021-10-13** `10817d9f027f`: 1 breaking, 8 warning, 3 info
- **2021-09-30** `cc928775a6cd`: 1 info
- **2021-07-23** `9ccd147a4041`: 1 info
- **2021-06-08** `ada64414e2a1`: 1 breaking, 1 warning, 8 info
- **2021-06-08** `7453480b119d`: 8 breaking, 1 info
- **2021-03-25** `fa0c80f3026a`: 2 breaking, 8 info
- **2021-03-25** `b7fec0c0a304`: 1 breaking, 9 warning, 1 info
- **2021-02-04** `894104a9ac72`: 1 info
- **2020-12-11** `0539b5bd93f9`: 1 info
- **2020-09-24** `c6971ce94867`: 2 info
- **2020-09-17** `7870cd3badc9`: 3 info
- **2020-09-17** `94cf1ab00383`: 3 breaking
- **2020-09-17** `155e084b2859`: 2 warning, 3 info
- **2020-09-17** `81608fb35d24`: 2 info
- **2020-09-17** `8e843a4b126e`: 2 info
- **2020-09-09** `a14b106f1592`: 13 breaking, 4 warning, 3 info

## Changes

- **2026-07-17** `886deae8a6f9`: 1 info
  - added the media type `application/json` for the response with the status `422`
- **2022-04-29** `e11f54229b64`: 2 warning
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/notes`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/restrictedNotes`
- **2022-01-14** `1619bcaae2df`: 2 breaking, 2 warning
  - the `allOf[#/components/schemas/CaseArray]/cases/items/location/country` request property's minLength was increased from `0` to `2`
  - the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/country` request property's minLength was increased from `0` to `2`
  - the `allOf[#/components/schemas/CaseArray]/cases/items/location/country` request property's maxLength was set to `2`
  - the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/country` request property's maxLength was set to `2`
- **2022-01-06** `875e892119b9`: 1 info
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/SGTF`
- **2021-10-13** `10817d9f027f`: 1 breaking, 8 warning, 3 info
  - the `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/` request property type changed from `object` to no type
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/administrativeAreaLevel1`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/administrativeAreaLevel2`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/administrativeAreaLevel3`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/country`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/geoResolution`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/geometry`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/place`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/query`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/batch`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/date`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines/items/sideEffects`
- **2021-09-30** `cc928775a6cd`: 1 info
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines`
- **2021-07-23** `9ccd147a4041`: 1 info
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/restrictedNotes`
- **2021-06-08** `ada64414e2a1`: 1 breaking, 1 warning, 8 info
  - request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution` was restricted to a list of enum values
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/query`
  - the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry/latitude` became optional
  - the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry/longitude` became optional
  - added the new `Admin1` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new `Admin2` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new `Admin3` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new `Country` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new `Point` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new `undefined` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
- **2021-06-08** `7453480b119d`: 8 breaking, 1 info
  - the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry/latitude` became required
  - the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry/longitude` became required
  - removed the enum value `Admin1` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Admin2` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Admin3` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Country` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Point` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `undefined` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/query`
- **2021-03-25** `fa0c80f3026a`: 2 breaking, 8 info
  - removed `#/components/schemas/Location, subschema #2` from the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location` request property `oneOf` list
  - the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location` request property type changed from no type to `object`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/administrativeAreaLevel1`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/administrativeAreaLevel2`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/administrativeAreaLevel3`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/country`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/name`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/place`
- **2021-03-25** `b7fec0c0a304`: 1 breaking, 9 warning, 1 info
  - the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location` request property type changed from `object` to no type
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/administrativeAreaLevel1`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/administrativeAreaLevel2`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/administrativeAreaLevel3`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/country`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/name`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/place`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/query`
  - added `#/components/schemas/Location, subschema #2` to the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location` request property `oneOf` list
- **2021-02-04** `894104a9ac72`: 1 info
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/variant`
- **2020-12-11** `0539b5bd93f9`: 1 info
  - added the new `EXCLUDED` enum value to the request property `allOf[#/components/schemas/CaseArray]/cases/items/caseReference/verificationStatus`
- **2020-09-24** `c6971ce94867`: 2 info
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/location/query`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/query`
- **2020-09-17** `7870cd3badc9`: 3 info
  - added the required property `errors` to the response with the `207` status
  - added the required property `phase` to the response with the `207` status
  - added the success response with the status `200`
- **2020-09-17** `94cf1ab00383`: 3 breaking
  - removed the required property `errors` from the response with the `207` status
  - removed the required property `phase` from the response with the `207` status
  - removed the success response with the status `200`
- **2020-09-17** `155e084b2859`: 2 warning, 3 info
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/location/query`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/query`
  - the response property `errors` became required for the status `207`
  - the response property `phase` became required for the status `207`
  - added the success response with the status `200`
- **2020-09-17** `81608fb35d24`: 2 info
  - added the optional property `errors` to the response with the `207` status
  - added the optional property `phase` to the response with the `207` status
- **2020-09-17** `8e843a4b126e`: 2 info
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/location/query`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/query`
- **2020-09-09** `a14b106f1592`: 13 breaking, 4 warning, 3 info
  - the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry/latitude` became required
  - the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geometry/longitude` became required
  - removed the enum value `Admin1` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Admin2` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Admin3` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `Country` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `EXCLUDED` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/caseReference/verificationStatus`
  - removed the enum value `Point` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the enum value `undefined` of the request property `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/geoResolution`
  - removed the media type `application/json` for the response with the status `422`
  - removed the required property `errors` from the response with the `207` status
  - removed the required property `phase` from the response with the `207` status
  - removed the success response with the status `200`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/SGTF`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/location/query`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/vaccines`
  - removed the request property `allOf[#/components/schemas/CaseArray]/cases/items/variant`
  - added the new optional request property `allOf[#/components/schemas/CaseArray]/cases/items/notes`
  - the `allOf[#/components/schemas/CaseArray]/cases/items/location/country` request property's minLength was decreased from `2` to `0`
  - the `allOf[#/components/schemas/CaseArray]/cases/items/travelHistory/travel/items/location/country` request property's minLength was decreased from `2` to `0`

---

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