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

# Create or update one or multiple entities.

`POST /samples/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 `PUS` of the request property `items/sampleMaterial`
- **2026-05-11** `a4d6c0ecfc78` — 1 info
  - added the new `PUS` enum value to the request property `items/sampleMaterial`
- **2026-04-07** `c409502e0543` — 34 info
  - added the new `AMNIOTIC_FLUID` enum value to the request property `items/sampleMaterial`
  - added the new `ANTIBIOTIC_SUSCEPTIBILITY` enum value to the request property `items/requestedPathogenTests/items/`
  - added the new `BEIJINGGENOTYPING` enum value to the request property `items/requestedPathogenTests/items/`
  - added the new `BIOPSY` enum value to the request property `items/sampleMaterial`
  - …30 more
- **2024-06-05** `8fcd6fbef5e6` — 86 breaking, 2 info
  - removed the enum value `ABSCESS_SWAB` of the request property `items/sampleMaterial`
  - removed the enum value `ACID_FAST_STAIN` of the request property `items/requestedPathogenTests/items/`
  - removed the enum value `AMNIOTIC_FLUID` of the request property `items/sampleMaterial`
  - removed the enum value `ANTIBIOTIC_SUSCEPTIBILITY` of the request property `items/requestedPathogenTests/items/`
  - …84 more

[Change history](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api/changes/samples/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)