---
title: "Create or update one or multiple entities."
method: POST
path: "/persons/push"
tags: ["Person Controller"]
---

# Create or update one or multiple entities.

`POST /persons/push`

A uuid will be generated for any entity that doesn't have one yet. Posting entities without uuid multiple times will also create them multiple times.

## Response `207`

Array of responses, matching the posted array of entities. Provides an HTML status code for every entity and an optional body (e.g. a string with an error message).

- PostResponse[]
  - `body` object
  - `statusCode` integer

## Other responses

- `default` — When the request body has one or no entry. The status code of the response entry matches the response code and may have an optional body (e.g. a string with an error message).

## Changes

- **2026-05-13** `ecb25b0812f3` — 1 breaking
  - removed the enum value `SHIGELLOSIS` of the request property `items/causeOfDeathDisease`
- **2026-05-11** `a4d6c0ecfc78` — 1 info
  - added the new `SHIGELLOSIS` enum value to the request property `items/causeOfDeathDisease`
- **2026-05-11** `ecb25b0812f3` — 1 info
  - added the new `SALMONELLOSIS` enum value to the request property `items/causeOfDeathDisease`
- **2026-04-07** `c409502e0543` — 15 info
  - added the new optional request property `items/birthWeightCategory`
  - added the new optional request property `items/emancipated`
  - added the new optional request property `items/entryDate`
  - added the new optional request property `items/gestationalAgeCategory`
  - …11 more
- **2024-06-05** `8fcd6fbef5e6` — 9 breaking, 9 warning
  - removed the enum value `CRYPTOSPORIDIOSIS` of the request property `items/causeOfDeathDisease`
  - removed the enum value `GIARDIASIS` of the request property `items/causeOfDeathDisease`
  - removed the enum value `INFLUENZA` of the request property `items/causeOfDeathDisease`
  - removed the enum value `INVASIVE_MENINGOCOCCAL_INFECTION` of the request property `items/causeOfDeathDisease`
  - …14 more

[Change history](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api/changes/persons/push/post.md)

---

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